OAuth 接続を作成する
- 最終更新日2025/04/02
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（アイデンティティプロバイダー）と相談して、必要なスコープを決定します。
- 次の表には認証されたアプリケーションがリストされていますが、を使用してエンタープライズアプリケーションを構成できます。プロバイダータイプをカスタムとして選択します。
- 有効期間が長く構成されているリフレッシュ トークンを使用することをお勧めします。 [AuthConfig アプリを使用して OAuth2 サービスを有効化する]を参照してください。
OAuthの主要コンポーネントの例
| エンタープライズ アプリケーション | 認可 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 |
|
| 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 接続の作成方法を紹介します。