Azure ADSSO

SAML SSOの制限

SAML SSOは、一部のプランでのみ利用できます。SAML SSOが Workspaceのプランで利用可能かどうかは、サポートまでお問い合わせください。

SAML SSO機能は上記のプランに紐づいているため、無料プランにダウングレードすると、この機能は利用できなくなります。Workspaceのすべてのメンバーにダウングレードに関するメールが送信されます。SAML SSOをWorkspaceで再び使用したい場合は、2週間以内に再アップグレードしてください。

SAML SSOをWorkspaceに接続する前に:

Entra IDにログインしているEntra ID管理者がすぐに対応できる状態にしてください。
Workspace のオーナーのみが、Bitrise Workspace に SAML SSO を設定できる点にご注意ください。
Bitrise のアカウントに、有料プランのいずれかの Workspace があります。

次の作業が必要です:

新しいアプリケーションとしてBitriseをEntra IDに追加する。
Entra ID上のBitriseアプリにユーザーとグループを追加する。
BitriseとEntra IDの間でSAMLSSOを設定する。

新しいアプリケーションとしてBitriseをEntra IDに追加するClick to copy link

管理者としてMicrosoft Azureにログインします。
Azure servicesページでAzure Active Directoryアイコンをクリックします。
Manageの下にあるEnterprise アプリケーションをクリックします。
New Applicationをクリックして、新しいアプリとしてBitriseをアカウントに追加します。
What’s the name of your app?フィールドにBitriseと入力します。Integrate any other application you don’t find in the galleryボタンが自動的に選択されているはずです。Createを押します。

新しく作成したアプリはAll Applicationsページの一覧に表示されます。
Bitriseアプリをクリックして、そのOverviewページに移動します。
続けてBitriseをSAMLアプリとして設定します。

Entra ID上のアプリへのユーザー/グループの追加Click to copy link

アプリにSAMLを設定する前に、SAML SSOを使ってBitrise Workspaceにログインするすべてのユーザー/グループをEntra IDのアプリに追加する必要があります。つまり、すべてのBitrise WorkspaceメンバーをEntra IDにユーザーとして追加する必要があります。

左側のメニューからUsers and groupsを選択します。
+ Add user/groupをクリックします。
Add AssignmentのUsersページで、リストからユーザーを選択してSelectをクリックします。完了すると、Select a roleドロップダウンでユーザーのロールを選択できます。
Add Assignmentページで、Assignをクリックしてユーザーの追加を完了します。

BitriseとEntra IDの間でのSAML SSOの設定Click to copy link

左側のメニューでSingle sign-onをクリックします。SAMLを選択します。
Set up Single Sign-On with SAMLページに移動します。
Basic SAML Configurationの鉛筆アイコンをクリックして、2つのフィールドを編集します。
Identifier (Entity ID)としてBitriseを追加します。このウィンドウは閉じずに開いたままにしてください。すぐにBitriseからの情報を使ってこのウィンドウに戻ります。

同じEntraインスタンスで複数のworkspacesを使用する場合
複数のBitrise workspaceが同じEntraIDインスタンスを使用する場合、それぞれのworkspaceに固有のEntity IDを設定する必要があります。workspaceごとに、以降の手順でEntity IDが必要になった際にはそれぞれ固有のEntity IDを使用してください。
たとえば、Alpha workspaceとBeta workspaceがある場合、Entity IDとしてalphaとbetaを設定できます。
Bitrise上のworkspaceに戻ります: Workspace settingsページを開き、Single Sign-Onに移動します
同じEntraインスタンスを使用するworkspaceが複数ある場合は、Application identifierフィールドにそれぞれ固有のEntity IDを追加します。
Copyボタンをクリックして、BitriseからAssertion Consumer Service URL (ACS URL)をコピーします。
Entra IDのBasic SAML Configurationウィンドウに戻りましょう。
BitriseのAssertion Consumer Service URLを、Entra IDのBasic SAML ConfigurationページにあるReply URLフィールドに貼り付けます。
Saveをクリックし、Basic SAML Configurationウィンドウを閉じます。
Entra IDのSingle sign-onページで、Set up Bitriseセクションまで下にスクロールします。
Login URLをコピーし、BitriseのSSO URLフィールドに貼り付けます。
Entra IDのSingle sign-onページで、少し上にスクロールしてSAML Signing Certificateセクションに移動します。
Certificate (Base64)の隣にあるDownloadをクリックして、証明書をローカルコンピューターにダウンロードします。
証明書ファイルを開き、その内容をBitriseのSAML SSO provider certificateフィールドにコピー&ペーストします。ローカルコンピューターからファイル自体をアップロードすることもできます。

(内容を手動で追加する場合は、----BEGIN CERTIFICATE-----と-----END CERTIFICATE-----を含む全内容が必要です。)
BitriseのWorkspace settingsページを開き、Single Sign-Onに移動します。
Configure SSOをクリックします。