テナント向け外部アイデンティティプロバイダーの設定

注: 外部アイデンティティプロバイダーを設定すると、Resource Owner Password Credentials 認証フローは使用できません。

1. 外部アイデンティティプロバイダーを構成します（OAuth 2.0 外部アイデンティティプロバイダーの構成 または SAML 2.0 外部アイデンティティプロバイダーの構成）。これらのセクションで説明されている外部認証パラメーターを準備します。
2. 構成した外部認証をテストします。
3. ABBYY Vantage で、左ペインの Configuration タブをクリックします。
4. Identity Provider をクリックし、External Identity Provider を選択します。
5. ドロップダウンリストで、使用するプロトコル（OAuth または SAML）を選択します。

6. Apply Changes をクリックします。

Note: Vantage のアイデンティティプロバイダーにリセットまたは戻す場合は、このページで Vantage を選択し、Apply Changes をクリックします。これはユーザーの現在のセッション（アクセストークン）が有効な間に適用されます。失効している場合は、設定済みの外部アイデンティティプロバイダーを通じて認証し、テナントへのアクセスを取得する必要があります。その場合は、システム管理者に連絡してください。

1. ABBYY Vantage の左ペインで Configuration タブをクリックします。  
2. Identity Provider をクリックし、External Identity Provider を選択します。  
3. ドロップダウンリストから Default Role for New Users を探します。  
4. テナントで新規に作成されるすべてのユーザーに自動的に割り当てるロールを 1 つ以上選択します。  
5. Apply Changes をクリックします。  

• 選択したロールは、テナントで新規に作成されるすべてのユーザーに自動的に適用されます。  
• 選択した各ロールについて、Allow all for current and further skills トグルは既定で有効です。これにより、初期設定としてすべての Skill へのアクセスが付与されます。管理者は、Users 設定画面でいつでもこれらの権限を変更できます。  
• 利用可能なロールと権限の詳細については、Authentication using an External Identity Provider を参照してください。 

1. Vantage API で認証します（詳細は Authentication ドキュメントを参照）。
2. https://<your-vantage-url>/api/adminapi2/v1/tenants/<tenantId>/external-providers/ に、ヘッダー Authorization = Bearer <access token> を付与した PUT リクエストを送信し、以下のリクエスト本文パラメーターを含めます。

curl --location --request PUT "https://<your-vantage-url>/api/adminapi2/v1/tenants/<tenantId>/external-providers/"
-H "Authorization: Bearer <token>"
{
  "providerSettings": {
    "kind": "Saml2",
    "settings": {
      "Metadata": "<SAML XML file contents>"
    }
  }
}

curl --location --request PUT 'https://<your-vantage-url>/api/adminapi2/v1/tenants/<tenant-id>/external-providers/'
-H 'Authorization: Bearer <token>'
{
  'providerSettings': {
    'kind': 'Saml2',
    'settings': {
      'Metadata': '<SAML XML file contents>'
    }
  }
}