OAuth 接続の作成
- 最終更新日2024/11/05
OAuth 接続の作成
Control Room 管理者は、ユーザーに対して OAuth 接続を作成して、認証の詳細を入力しなくてもパッケージの認証アクションでその接続を使用できるようにすることができます。
注記： Salesforce のマークとロゴ、Microsoft SharePoint のマークとロゴ、Apigee のマークとロゴ、ServiceNow のマークとロゴ、Genesys のマークとロゴは、それぞれ Salesforce, Inc.、Microsoft Corp.、Google LLC、ServiceNow, Inc.、Genesys の商標または登録商標であり、識別のみを目的として使用されています。
前提条件
- [接続をマネージ] 権限が有効になっているユーザー ロールを使用して [OAuth 接続] 機能を利用していることを確認してください。 「ロールに対する機能のアクセス許可」を参照してください。
- エンタープライズ アプリケーションを構成しており、クライアント ID、クライアント シークレット、認証 URL、トークン URL、範囲を記録していることを確認してください。 「エンタープライズ アプリケーションを構成する」を参照してください。注: 接続エラーを避けるために、上記の前提条件を考慮してください。
エンタープライズ アプリケーション 認可 URL トークン URL 範囲 Apigee https://accounts.google.com/o/oauth2/auth?prompt=consent&access_type=offline https://accounts.google.com/o/oauth2/token https://www.googleapis.com/auth/cloud-platform Genesys https://login.<yourinstance>.pure.cloud/oauth/authorize https://login.<yourinstance>.pure.cloud/oauth/token 不要 Microsoft Entra https://login.microsoftonline.com/<tenant>/oauth2/v2.0/authorize https://login.microsoftonline.com/<tenant>/oauth2/v2.0/token 認証コードフロー: offline_access, openid またはクライアント資格情報フロー: https://graph.microsoft.com/.defaultSalesforce https://<yourinstance>.salesforce.com/services/oauth2/authorize https://<yourinstance>.salesforce.com/services/oauth2/token api、refresh_token、offline_access ServiceNow https://<yourinstance>.service-now.com/oauth_auth.do https://<yourinstance>.service-now.com/oauth_token.do 不要 SharePoint https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/authorize https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token https://<domain-name>/AllSites.Manage, offline_access, openid 注: OpenID 範囲は、アプリがエンドユーザーを識別するために ID トークンの sub 請求を必要とする場合にのみ必要です。 それ以外の場合、この範囲はオプションです。Google Workspace（カレンダー、ドライブ、シート とGmail） https://accounts.google.com/o/oauth2/auth?prompt=consent&access_type=offline https://oauth2.googleapis.com/token - Google シート: https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/spreadsheets
- Google ドライブ: https://www.googleapis.com/auth/drive
- Google カレンダー: https://www.googleapis.com/auth/calendar
- Gmail : https://developers.google.com/identity/protocols/oauth2/scopes#gmail
- https://mail.google.com/,https://www.googleapis.com/auth/gmail.readonly,https://www.googleapis.com/auth/gmail.send
注: 有効時間が長く構成されている更新トークンを使用することをお勧めします。 「AuthConfig アプリを使用した OAuth2 サービスの有効化」を参照してください。
手順
- オプション:
接続の [説明] を入力します。
- オプション:
[範囲] を入力します。
この情報は、アクセス トークンの請求 (ユーザーに関する情報) として使用され、リソース サーバーに転送され、アクセスを制限します。注: 複数の範囲を追加する場合は、区切り文字のカンマまたはスペースを使用して区切ってください。 - オプション:
[変更を保存して接続をテスト] をクリックします。
注: [変更を保存して接続をテスト] オプションをクリックした後、接続に成功した場合、[次へ] ボタンは無効になります。 [戻る] ボタンをクリックし、再度 [クライアント シークレット] を入力して [次へ] をクリックします。 以前に提供した認証情報の詳細に変更を加えない限り、接続を再度テストする必要はありません。 -
この接続を使用するために招待するロールを選択します。 招待されたロールのみが、プライベートまたは共有にかかわらず、Bot でトークンを使用できます。
Botが OAuth 接続を使用する場合、ロールを招待アクションは必須です。 このアクションは任意です、外部サービスがOAuth接続を使用する場合。
注: [利用可能なロール] のリストにはカスタム ロールのみが表示されます。
次のビデオでは、OAuth 接続の作成方法を紹介します。