テナント用の外部 ID プロバイダーの設定

注: 外部 ID プロバイダーを設定すると、Resource Owner Password Credentials 認証フローは使用できなくなります。

1. 外部 ID プロバイダーを構成します（OAuth 2.0 外部 ID プロバイダーの構成 または SAML 2.0 外部 ID プロバイダーの構成 を参照）。これらのセクションに従って、外部認証パラメーターを準備します。
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>'
    }
  }
}