Okta Org2OrgをOktaと統合する

Okta Org2Orgの統合を使用して、ソースOkta orgからターゲットorgにユーザーを認証し、任意でプロビジョニングできます。この統合はソースorgでインストールおよび構成されます。Okta Org2Orgを使用して複数のソースorgを1つのOktaターゲットorgに接続できます。この統合によって、ユーザーをソースorgからターゲットorgにプッシュできるようになります。

Org2Orgアプリのプロビジョニング機能を利用する場合、OAuth 2.0またはAPIトークンを使用してorg間の接続を保護できます。

Org2Orgが使用される一般的なシナリオは、ハブアンドスポークモデルです。これらのシナリオでは、スポークorgがソースorgであり、ハブorgがターゲットorgです。

org間のフェデレーションを構成する

この手順では、OktaソースorgでOkta Org2Orgを構成することを前提としています。

1. ソースorgでAdmin Consoleを開き、［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。
2. ［Browse App Catalog（アプリカタログを参照）］をクリックします。
3. ［Search（検索）］フィールドにOrg2Orgと入力し、Okta Org2Orgを選択します。
4. ［Add Integration（統合を追加）］をクリックします。
5. ［General Settings（一般設定）］ページのフィールドに入力し、［Next（次へ）］をクリックします。
6. ［sign-on option（サインオンオプション）］を選択します。［SAML 2.0］を選択した場合、［View Setup Instructions（セットアップ手順を表示）］をクリックして手順に従います。
7. ［Done（完了）］ をクリックします。
8. ［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。
   1. Org2Orgアプリを開き、［Sign On（サインオン）］タブに切り替えます。
   2. ［View SAML setup Instructions（SAMLのセットアップ手順を表示）］をクリックします。指示に従って、Org2Orgアプリと連携するようにターゲットorgでIdPを作成します。詳細およびセキュリティのベストプラクティスについては、「SAML IDプロバイダーを追加する」を参照してください。
   3. 次の手順で使用するため、IdP Single Sign On URL（IdPのシングルサインオンURL）の値をコピーします。
9. Org2Orgアプリの［Assignments（割り当て）］タブに切り替えます。次の手順を完了してOrg2Orgアプリにユーザーとグループを割り当てます。
   1. ［Assign（割り当て）］をクリックして、［Assign to People（ユーザーに割り当てる）］または［Assign to Groups（グループに割り当てる）］を選択します。
   2. ユーザーまたはグループ名の横にある［Assign（割り当て）］をクリックするか、［Search（検索）］フィールドを使ってユーザーまたはグループを特定し、［Assign（割り当て）］をクリックします。
10. ソースorgのユーザーがアクセスできるように、ターゲットorgで1つ以上のアプリを構成します。
    1. ターゲットorgでアプリを作成して構成します。
    2. アプリの［General（一般）］タブの［App Embed Link（アプリの埋め込みリンク）］セクションで［Embed Link（埋め込みリンク）］の値をコピーします。
    3. ソースorgでブックマークアプリ統合を作成します。
    4. 次の値を連結してブックマークアプリのURLを作成します。
       • IdP Single Sign On URL（IdPのシングルサインオンURL） （例：https://sourceorg.okta.com/app/okta_org2org/app_ext_id/sso/saml）
       • ?RelayState=
       • アプリの［Embed Link（埋め込みリンク）］の値（例：https://targetorg.okta/home/app_name/instance_id/app_id）

       たとえば、ブックマークアプリのURLを作成するには、前述の値を次のように連結します。https://sourceorg.okta.com/app/okta_org2org/app_ext_id/sso/saml?RelayState=https://targetorg.okta/home/app_name/org_id/app_id

11. 任意。OAuth 2.0（推奨）またはAPIトークンを使用した、ソースorgからターゲットorgへのプロビジョニングを有効にします。

ソースからターゲットへのプロビジョニングを有効にする

プロビジョニングは必要だが、ユーザー、ユーザープロファイル属性、グループのリアルタイム同期は不要な場合、ターゲットorgに手動でソースorgユーザーを作成してください。

1. ソースorgで、アクティブユーザーのリストをエクスポートします。Admin Consoleで、［Reports（レポート）］に移動し、［Okta Password Health（Oktaパスワードの健全性レポート）］をクリックします。レポートが生成され、メールアドレスに送信されます。レポートをダウンロードすることもできます。CSVファイルを開いて、［Status（ステータス）］列でフィルタリングしてアクティブユーザーを確認します。
2. ターゲットorgでCSVファイルからユーザーをインポートします。ソースorgのグループ、アクセスが必要なアプリのすべてのグループにユーザーを割り当てます。
3. ソースorg用に構成されたIdpに、新しく作成されたユーザーを手動でリンクします。

ユーザーのプロビジョニングおよびリアルタイム同期が必要な場合、次のいずれかの方法を選択します。

• プロビジョニングにOAuth 2.0を使用する（自動キーローテーション）
• プロビジョニングにOAuth 2.0を使用する（手動キー構成）
• APIトークンを使用したプロビジョニング

OAuthメソッドでは、APIトークンを使用してアプリのOAuth 2.0プロビジョニングを有効化しますが、その後はトークンは使用されません。OAuth 2.0アプローチは、プロビジョニングにAPIトークン方式を使用するよりも安全で、より細かい権限設定が可能です。

プロビジョニングにOAuth 2.0を使用する（自動キーローテーション）

早期アクセスリリース。「セルフサービス機能を有効にする」を参照してください。

この方法により、キーが自動的にローテーションされ、手動でキーを管理する必要がなくなります。

1. ソースorgでAdmin Consoleを開き、［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。
   1. Org2Orgアプリを開きます。
   2. ［プロビジョニング］タブに移動し、［Settings（設定）］メニューの下の［Integration（統合）］を選択します。
   3. ［Edit（編集）］をクリックします。
   4. ［Authentication Scheme（認証スキーム）］をOAUTH Auto-Rotation (recommended)（OAUTH自動ローテーション（推奨））に設定します。
   5. ［Client Public Key URL（クライアント公開鍵のURL）］の横にある［Copy（コピー）］ボタンをクリックします。
2. ターゲットorgでAdmin Consoleを開き、［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。
   1. OAuth 2.0サービスアプリを作成します。「APIサービス統合を追加する」を参照してください。
   2. ［一般］タブで［クライアントの資格情報］セクションに移動し、［Edit（編集）］をクリックします。
   3. ［Client authentication（クライアント認証）］をPublic key / Private key（公開鍵/秘密鍵）に設定します。
   4. ［Configuration（構成）］をUse a URL to fetch keys dynamically（URLを使用してキーを動的に取得）に設定します。
   5. 手順1のクライアント公開鍵のURLを［URL］フィールドに貼り付けて、［Save（保存）］をクリックします。
   6. ［管理者ロール］タブに移動して、［Edit assignments（割り当てを編集）］をクリックします。
   7. ［Role（ロール）］ドロップダウンメニューのOrganization Administrator（組織管理者）を選択し、［Save Changes（変更を保存）］をクリックします。
   8. ［Okta APIスコープ］タブでokta.groups.manageスコープを付与します。これにより、アプリはユーザープロファイルと資格情報を作成および管理できるようになります。グループプッシュを構成する場合は、okta.groups.manageスコープを付与します。
   9. ［一般］タブで［一般設定］セクションに移動して、［Edit（編集）］をクリックします。
   10. ［Require Demonstrating Proof of Possession (DPoP) header in token requests（トークンリクエストのDPoP（Demonstrating Proof of Possession）ヘッダーを必須にする）］チェックボックスを選択して、［Save（保存）］をクリックします。
   11. ［一般］タブで［クライアントの資格情報］セクションに移動して、［Client ID（クライアントID）］をコピーします。
3. ソースorgで、［Target Org Client ID（ターゲットorgのクライアントID）］フィールドにクライアントIDを貼り付け、［Save（保存）］をクリックします。
4. 任意。［Test API Credentials（API資格情報をテスト）］をクリックして、ターゲットorgが正常に検証されていることを確認します。
5. ソースorgで、Org2Org用のプロビジョニング設定を構成します。
   1. Admin Consoleで、［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。
   2. Org2Orgアプリを開きます。
   3. ［Provisioning（プロビジョニング）］タブで、［Okta Org2Org Attribute Mappings（Okta Org2Orgの属性マッピング）］セクションに移動し、initialStatus属性を見つけます。［Edit（編集）］をクリックします。
   4. 希望する設定を選択し、［Save（保存）］をクリックします。
6. 任意。Org2Orgプロビジョニングをテストします。
   1. ［アプリにプロビジョニング］セクションで［Edit（編集）］をクリックします。
   2. ［Create Users（ユーザーの作成）］、［Update Users（ユーザーの更新）］、［Deactivate Users（ユーザーの非アクティブ化）］を選択し、［Save（保存）］をクリックします。
   3. グループにアプリを割り当てます。［Assignments（割り当て）］タブで［Assign（割り当て）］［Assign to Groups（グループに割り当てる）］をクリックし、グループを選択して［Save and Go Back（保存して戻る）］をクリックします。［Done（完了）］ をクリックします。構成済みグループに属するユーザーを一覧表示するには、ユーザー別で割り当てをフィルタリングします。
   4. ターゲットorgのAdmin Consoleに移動します。［Directory（ディレクトリ）］［People（ユーザー）］に移動して、ソースorgでOrg2Orgアプリに割り当てられたユーザーがプロビジョニングされていることを確認します。

プロビジョニングにOAuth 2.0を使用する（手動キー構成）

org間のOAuth 2.0プロビジョニングを有効にするには、Okta APIとAdmin Consoleを連携する必要があります。

1. ソースorgでAdmin Consoleを開き、［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。
   1. Org2Orgアプリを開きます。
   2. URLからアプリIDをコピーします。たとえば、URLが<sourceorg>/admin/app/okta_org2org/instance/0oa78guhzaGH4KHZt1d7/#tab-importの場合、IDは0oa78guhzaGH4KHZt1d7です。
2. 前の手順でコピーしたアプリIDを渡し、Org2Orgアプリのキー資格情報を一覧表示します。
3. ターゲットorgでAPIサービス統合を追加します。前の手順で取得したキーの資格情報をjwksオブジェクトのkeysエントリとして使用します。
4. ターゲットorgでAdmin Consoleを開き、［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。OAuth 2.0サービスアプリを開きます。
5. ［Admin roles（管理者ロール）］タブで［Edit assignments（割り当てを編集）］をクリックします。
6. ［+ Add assignment（+割り当てを追加）］をクリックし、［Role（ロール）］ドロップダウンリストで［Group Administrator（グループ管理者）］を選択します。
7. ［Save Changes（変更を保存）］をクリックします。
8. APIスコープに同意を付与して、サービスアプリでユーザーを作成してユーザープロファイルと資格情報を管理できるようにします。
   1. ターゲットorgでAdmin Consoleを開き、［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。OAuth 2.0サービスアプリを開きます。
   2. ［Okta API Scopes（APIスコープ）］タブで、okta.groups.manageスコープとokta.users.manageスコープに同意を付与します。
9. 任意。プロビジョニングを有効にして、アカウントの作成、更新、非アクティブ化を自動化します。
   1. ターゲットorgでAdmin Consoleを開き、［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。OAuth 2.0サービスアプリを開き、［General（一般）］ タブでクライアントIDをコピーします。
   2. ソースorgで、Okta APIを使用してOAuth 2.0ベースのプロビジョニングを有効にします。
   3. ソースorgで、Org2Org用のプロビジョニング設定を構成します。
      1. Admin Consoleで、［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。
      2. Org2Orgアプリを開きます。
      3. ［Provisioning（プロビジョニング）］タブで、［Okta Org2Org Attribute Mappings（Okta Org2Orgの属性マッピング）］セクションに移動し、initialStatus属性を見つけます。［Edit（編集）］をクリックします。
      4. 希望する設定を選択し、［Save（保存）］をクリックします。
   4. 任意。Org2Orgプロビジョニングをテストします。
      1. ［アプリにプロビジョニング］セクションで［Edit（編集）］をクリックします。
      2. ［Create Users（ユーザーの作成）］、［Update Users（ユーザーの更新）］、［Deactivate Users（ユーザーの非アクティブ化）］を選択し、［Save（保存）］をクリックします。
      3. グループにアプリを割り当てます。［Assignments（割り当て）］タブで［Assign（割り当て）］［Assign to Groups（グループに割り当てる）］をクリックし、グループを選択して［Save and Go Back（保存して戻る）］をクリックします。［Done（完了）］ をクリックします。構成済みグループに属するユーザーを一覧表示するには、ユーザー別で割り当てをフィルタリングします。
      4. ターゲットorgのAdmin Consoleに移動します。［Directory（ディレクトリ）］［People（ユーザー）］に移動して、ソースorgでOrg2Orgアプリに割り当てられたユーザーがプロビジョニングされていることを確認します。

APIトークンを使用したプロビジョニング

1. OktaターゲットorgでAPIトークンを作成します。
   1. Admin Consoleで、［Security（セキュリティ）］［API］に移動します。
   2. ［トークン］タブをクリックして［Create Token（トークンの作成）］をクリックします。
   3. トークン名としてわかりやすい名前を入力して、［Create Token（トークンを作成）］をクリックします。
   4. トークンの値をクリップボードまたはテキストエディターにコピーします。
   5. ［OK, got it（OK、了解）］をクリックします。
2. ソースorgでAdmin Consoleを開き、［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。
3. アプリのリストからOkta Org2Orgを選択します。
4. ［Provisioning（プロビジョニング）］タブをクリックし、［Configure API Integration（API統合を構成）］をクリックして［Enable API Integration（API統合を有効化）］を選択します。
5. 次のフィールドに情報を入力します。
   • Security token（セキュリティトークン）：事前にコピーしたセキュリティトークンを貼り付けます。
   • ［Prefer Username Over Email（メールよりユーザー名を優先）］：任意。メールアドレスをユーザー名として使用したくない場合にこのオプションを選択します。
   • ［Import Groups（グループのインポート）］：任意。接続したorgからグループをインポートしたくない場合はこのチェックボックスをオフにします。
6. 任意。［Test API Credentials（API資格情報をテスト）］をクリックしてAPI統合をテストします。
7. ［Save（保存）］をクリックします。

8. 任意。Oktaターゲットorgからソースorgへプロビジョニング設定を変更します。

   1. ［Provisioning（プロビジョニング）］タブをクリックし、［Settings（設定）］で［To App（アプリへ）］を選択します。
   2. ［Edit（編集）］をクリックします。
   3. ［Create Users（ユーザーを作成）］、［Update User Attributes（ユーザー属性を更新）］、［Deactivate Users（ユーザーを非アクティブ化）］、または［Sync Password（パスワードを同期化）］チェックボックスを選択します。
   4. ［Save（保存）］をクリックします。
9. 任意。ソースorgからターゲットOkta orgへのプロビジョニング設定を変更します。
   1. ［Provisioning（プロビジョニング）］タブをクリックし、［Settings（設定）］で［To Okta（Oktaへ）］を選択します。
   2. ［General（一般）］、［User Creation & Matching（ユーザーの作成と一致）］、［Profile & Lifecycle Sourcing（プロファイルおよびライフサイクルソーシング）］、または［Import Safeguard（インポートセーフガード）］エリアで［Edit（編集）］をクリックして設定を編集します。

      ［Profile & Lifecycle Sourcing（プロファイルおよびライフサイクルソーシング）］エリアの［Allow Okta Org2Org to source Okta users（Okta Org2OrgにOktaユーザーのソーシングを許可）］を選択すると、ソースorgがユーザープロファイルデータのソースとなります。Oktaユーザーをターゲットorgにインポートすると、ソースorgのユーザープロパティに加えられた変更が、そのユーザーが割り当てられているほかのアプリにも適用されます。

   3. ［Save（保存）］をクリックします。
   4. 初期ステータス（initialStatus）用にオプションを選択します。この属性は接続orgのユーザーが作成、リンク、または再アクティブ化されたときの、ユーザーのステータスを定義します。active_with_passまたはpending_with passを選択した場合、ユーザー向けに一時パスワードが作成されます。［Okta Password Sync（Oktaパスワード同期）］を有効にした場合、ユーザーがサインインしたときにユーザーの一時パスワードは上書きされます。初期ステータスにおける［Attribute value（属性の値）］の最も一般的な構成は、 ［Same value for all users（すべてのユーザーで同一の値）］およびactive_with_passです。［Edit（編集）］をクリックします。希望する設定を選択し、［Save（保存）］をクリックします。
10. 任意。新しいOktaグループを接続orgにプッシュします。「グループプッシュを管理する」を参照してください。