OAuth 接続を作成する
- 最終更新日2025/10/28
OAuth 接続を作成する
Control Room 管理者は、ユーザーに対して OAuth 接続を作成し、認証の詳細を入力せずにパッケージの認証アクションでその接続を使用できるようにすることができます。
Salesforce のマークとロゴ、Microsoft SharePoint のマークとロゴ、Apigee のマークとロゴ、ServiceNow のマークとロゴ、Genesys のマークとロゴは、それぞれ Salesforce, Inc.、Microsoft Corp.、Google LLC、ServiceNow, Inc.、Genesys の商標または登録商標であり、識別のみを目的として使用されています。
Cloud Control Room インスタンスで作成された外部 OAuth 接続については、認証 URL やトークン URL などのすべての外部エンドポイントが、ネットワーク境界ファイアウォール ルールを通じて Cloud Control Room から到達可能である必要があります。 ネットワーク ファイアウォールを構成し、Automation Anywhere のアウトバウンド IP アドレスを許可リストに追加してください。 外部統合の Control Room IP アドレスを参照してください。
前提条件
- Control Room サーバーがプロキシの背後にあり、外部接続がプロキシを通過する必要がある場合は、フォワード プロキシ設定の構成 に詳述されているようにフォワードプロキシ設定を構成してください。
- OAuth 接続 機能に対して 接続をマネージ 権限が有効になっているユーザー ロールを使用していることを確認してください。 ロールに対する機能の権限を参照してください。
- 複数の範囲を追加する場合は、カンマで区切ってください。
例: api、refresh_token、offline_access
- エンタープライズ アプリケーションを構成しており、クライアント ID、クライアント シークレット、認証 URL、トークン URL、Scopeを記録していることを確認してください。 エンタープライズ アプリケーションを構成するを参照してください。注:
- 接続エラーを避けるために、上記の前提条件を考慮してください。
- 次の表には認証されたアプリケーションがリストされていますが、を使用してエンタープライズアプリケーションを構成できます。プロバイダータイプをカスタムとして選択します。
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 |
注: OpenID 範囲は、アプリがエンドユーザーを識別するために ID トークンの sub 請求を必要とする場合にのみ必要です。 それ以外の場合、この範囲は任意です。
|
手順
- オプション:
接続の 説明 を入力します。
- オプション:
範囲 を入力します。
トークンの有効期限は、アイデンティティプロバイダーによって設定できます。 トークンが期限切れになると、Bot は offline_access スコープを使用して、Control Room の詳細に基づいて新しい有効なトークンを取得します。 Control Room で OAuth 接続を構成するを参照してください。
この情報は、アクセス トークンの請求 (ユーザーに関する情報) として使用され、リソース サーバーに転送され、アクセスを制限します。注: Control Room およびアイデンティティ プロバイダーを構成する際に、offline_access スコープまたは適切なリフレッシュ トークン スコープを追加することをお勧めします。これにより、アクセストークンが自動的に更新されるようになります。 そうでなければ、Control Room でトークンを手動で更新する必要があります。 ユーザー固有の OAuth 接続の認証を参照してください。 - オプション:
変更を保存して接続をテスト をクリックします。
注: 変更を保存して接続をテスト オプションをクリックした後、接続に成功した場合、次へ ボタンは無効になります。 戻る ボタンをクリックし、再度 クライアント シークレット を入力して 次へ をクリックします。 以前に提供した認証情報の詳細に変更を加えない限り、接続を再度テストする必要はありません。 -
この接続を使用するために招待するロールを選択します。 招待されたロールのみが、非公開または共有のどちらかにかかわらず、Bot でトークンを使用できます。
Bot が OAuth 接続を使用する場合、ロールを招待アクションは必須です。 このアクションは任意です、外部サービスがOAuth接続を使用する場合。
注: 利用可能なロール のリストにはカスタム ロールのみが表示されます。
次のビデオでは、OAuth 接続の作成方法を紹介します。