When you configure an outgoing link to an external application, Bamboo requests data from this application, which means that it acts as the OAuth client. This type of link is primarily used in Bamboo to create the OAuth 2.0 integration for popular mail servers. To learn more about the type of links and additional details, see Linking to another application.

When to use this

送信 OAuth 2.0 統合が用意されている主な理由は、Google と Microsoft が基本認証の廃止を発表したためです。つまり、基本認証を使用して認証する場合は、こうしたプロバイダー (Gmail、Microsoft Exchange Online) によってユーザーがメールから課題やコメントを作成できるようにできません。これを修正するには、こうしたプロバイダーとの OAuth 2.0 統合を設定して、メール サーバーの設定を更新する必要があります。

IMAP または POP3 を使用している場合は、引き続き機能するための操作は不要です。

はじめる前に

以下を確認する必要があります。

• サーバーは HTTPS 上で実行している必要があります。そうでない場合は、OAuth 2.0 を設定できません。

• Your base URL needs to be configured correctly. This is important as the redirect URL you’ll need to provide is based on Bamboo’s base URL.

手順

To create and configure an outgoing link:

1. From the top navigation bar, select Administration () > Overview.
2. On the Bamboo administration page, select Application links from the left menu.

3. [リンクを作成] を選択します。

4. In the Create link dialog, select External application, and then choose Outgoing as the direction.
   

5. Choose a service provider:

   • Google
   • Microsoft
   • Custom (for internal tools or other providers)

   Choosing Google or Microsoft lets you create an OAuth 2.0 integration for mail servers – in this case, some of the configuration fields will be pre-filled.

6. Copy the redirect URL and register it in your external application to obtain the client ID and client secret required to complete the configuration.

   If you’re using Google or Microsoft as service providers, you’ll be able to copy the redirect URL right away. For custom providers, you need to first provide the Authorization endpoint and Token endpoint. For more information on registering the URL with Google or Microsoft, check out the following guides:

   • Google の OAuth 2.0

   • Microsoft の OAuth 2.0

   Different providers might have different requirements related to the redirect URL. For example, Google doesn't allow it to be a private IP address. Make sure you provide an external URL (for example, of a load balancer for Bamboo Data Center).

7. Fill-in the remaining configuration details:

   名前	説明
   クライアント ID	The client ID that's generated by the external application after registering Bamboo’s redirect URL. This is the public identifier of the application.
   クライアント シークレット	The client secret that's generated by the external application after registering Bamboo’s redirect URL. This is the shared secret between Bamboo and the application, which ensures the authorization is secure.
   スコープ	The required OAuth 2.0 scopes (permissions) that control what Bamboo can do in the external application. You need to specify different scopes for email servers.  Google の場合は、次のスコープをお勧めします: https://mail.google.com (IMAP、POP3、および SMTP 用)。 Microsoft の場合は、使用するプロトコルに応じて、常に offline_access スコープと 1 つ以上の追加スコープを使用することをお勧めします。スコープは、Microsoft アカウントの種類とメール プロトコルの種類によって異なります。 If you're using non-GCC (Government Community Cloud) accounts, we recommend the following scopes: https://outlook.office.com/IMAP.AccessAsUser.All (for IMAP) https://outlook.office.com/POP.AccessAsUser.All (for POP3) https://outlook.office.com/SMTP.Send (for SMTP) offline_access GCC アカウントの場合は、以下を使用します。 https://outlook.office365.com/IMAP.AccessAsUser.All (for IMAP) https://outlook.office365.com/POP.AccessAsUser.All (for POP3) https://outlook.office365.com/SMTP.Send (for SMTP) offline_access For more information about scopes available in Google and Microsoft, see the detailed information at the Microsoft & Google sites.
   認証エンドポイント	OAuth 2.0 を使用するための認証が開始する HTTPS URL。
   トークン エンドポイント	The HTTPS URL where refresh token requests are sent. As OAuth 2.0 tokens have an expiry, Bamboo will periodically update the token.
   リダイレクト URL	The redirect URL that must be registered in the external application to obtain its client ID and client secret. This redirects the authentication flow back to Bamboo.

8. リンクを保存します。

トラブルシューティング

If you're facing some issues while configuring outgoing links for applications, check out our Application Links Troubleshooting Guide.