OAuth 接続を作成する
- 最終更新日2025/02/14
OAuth 接続を作成する
Control Room 管理者は、ユーザーに対して OAuth 接続を作成し、認証の詳細を入力せずにパッケージの認証アクションでその接続を使用できるようにすることができます。
注： Salesforce のマークとロゴ、Microsoft SharePoint のマークとロゴ、Apigee のマークとロゴ、ServiceNow のマークとロゴ、Genesys のマークとロゴは、それぞれ Salesforce, Inc.、Microsoft Corp.、Google LLC、ServiceNow, Inc.、Genesys の商標または登録商標であり、識別のみを目的として使用されています。
前提条件
- 接続をマネージ 権限が有効になっているユーザー ロールを使用して OAuth 接続 機能を利用していることを確認してください。 「ロールに対する機能の権限」を参照してください。
- 複数の範囲を追加する場合は、カンマで区切ってください。
例: api、refresh_token、offline_access
- エンタープライズ アプリケーションを構成しており、クライアント ID、クライアント シークレット、認証 URL、トークン URL、Scopeを記録していることを確認してください。 「エンタープライズ アプリケーションを構成する」を参照してください。注:
- 接続エラーを避けるために、上記の前提条件を考慮してください。
- OAuthを設定する際、スコープフィールドは任意です。 IDP（アイデンティティプロバイダー）と相談して、必要なスコープを決定します。
表 1. 例 エンタープライズ アプリケーション 認可 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 不要 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
Jira https://auth.atlassian.com/authorize https://auth.atlassian.com/oauth/token offline_access write:jira-work,read:jira-user,manage:jira-webhook,read:jira-work 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/.default Microsoft 365 Outlook 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/.default Salesforce 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 請求を必要とする場合にのみ必要です。 それ以外の場合、この範囲は任意です。
手順
- オプション:
接続の 説明 を入力します。
- オプション:
[範囲] を入力します。
トークンの有効期限は、アイデンティティプロバイダーによって設定できます。 トークンが期限切れになると、Bot は Offline_access スコープを使用して、Control Room の詳細に基づいて新しい有効なトークンを取得します。 「OAuth で Control Room 接続を構成する」を参照してください。
この情報は、アクセス トークンの請求 (ユーザーに関する情報) として使用され、リソース サーバーに転送され、アクセスを制限します。 - オプション:
変更を保存して接続をテスト をクリックします。
注: 変更を保存して接続をテスト オプションをクリックした後、接続に成功した場合、次へ ボタンは無効になります。 戻る ボタンをクリックし、再度 クライアント シークレット を入力して 次へ をクリックします。 以前に提供した認証情報の詳細に変更を加えない限り、接続を再度テストする必要はありません。 -
この接続を使用するために招待するロールを選択します。 招待されたロールのみが、非公開または共有のどちらかにかかわらず、Bot でトークンを使用できます。
Bot が OAuth 接続を使用する場合、ロールを招待アクションは必須です。 このアクションは任意です、外部サービスがOAuth接続を使用する場合。
注: 利用可能なロール のリストにはカスタム ロールのみが表示されます。
次のビデオでは、OAuth 接続の作成方法を紹介します。