メインコンテンツまでスキップ

Auth0SSO

このガイドでは、Auth0を使用してSAML SSOを設定する方法について説明します。

SAML SSOの制限

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

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

SAML SSOをWorkspaceに接続する前に、次の点を確認してください:

  • Auth0にログインしたAuth0管理者が手元にいること。
  • Workspace のオーナーのみが、Bitrise Workspace に SAML SSO を設定できる点にご注意ください。
  • Bitrise のアカウントに、有料プランのいずれかの Workspace があります。

次の作業が必要です:

  1. Auth0上でWebアプリケーションとしてBitriseを作成する。
  2. Auth0からSAML SSO情報を取得する。
  3. BitriseアプリのClient IDのマッピングルールを設定する。

Auth0上でWebアプリケーションとしてBitriseを作成するClick to copy link​

  1. 管理者としてAuth0にログインします。

  2. 左側のメニューバーでApplicationsをクリックし、Applicationsページの右側にある+ Create Applicationボタンをクリックします。

    authzero_createapp1.png

  3. Create applicationウィンドウで、NameフィールドにBitriseと入力します。Choose application typeでRegular Web Applicationsを選択し、Createボタンをクリックします。

    authzero_addappname2.png

  4. 新しく作成したBitriseアプリのQuick Startページが表示されます。Addonsタブをクリックします。SAML2 WEB APPのスイッチを右側に切り替えます。これにより自動的にAddon: SAML2 WEB APPページに移動します。

    authzero_addon4.png

  5. BitriseからAssertion Consumer Service URL (ACS URL)をコピーし、Addon: SAML2 WEB APPページのSettingsタブにあるApplication Callback URLフィールドに貼り付けます。Addon: SAML2 WEB APPページの一番下までスクロールし、SAVEをクリックします。

    authzero_settingsapplicationurl6.png

  6. Go back、Addonsページに戻ると、スイッチがオンになっていることを確認できます。

    authzero_samlappenabled8.png

Auth0からSAML SSO情報を取得するClick to copy link​

Auth0上でWebアプリケーションとしてBitriseを有効化したら、証明書とIDプロバイダー固有のログインURLを取得して、Bitrise上でのSAML設定を完了させましょう。

  1. Auth0でApplicationに移動し、Addonsタブを選択して有効化したBitriseアプリを見つけます。

  2. SAML2 WEB APPのWebアプリをクリックし、Usageタブを選択します。Identity Provider Certificateラベルの横にあるDownload Auth0 certificateリンクをクリックします。ダウンロードした証明書ファイルを開き、その内容をBitriseのSAML SSO provider certificateフィールドにコピーするか、ローカルコンピューターからファイル自体をアップロードします。Auth0に戻り、Identity Provider Login URLをコピーしてBitriseのSSO URLフィールドに貼り付けます。

    saml_sso_setup.png

    authzero_downloadcertificateusage9.png

  3. BitriseのConfigure SSOボタンをクリックします。

  4. これでAuth0のダイアログを閉じることができます。

BitriseアプリのClient IDのマッピングルールを設定するClick to copy link​

Bitriseはメールアドレスを介してSAML SSOユーザーを認証するため、SAML SSOをテストする前に、必ずAuth0で新しいマッピングルールを作成してください。これによりAuth0のClient IDをメールアドレスにマッピングし、Bitrise上でのSAML認証を成功させることができます。

  1. Auth0で、左側のメニューバーにあるAuth Pipelineをクリックします。Rulesをクリックします。

  2. + Createをクリックして、新しいマッピングルールを設定します。

  3. Pick a rules templateページで、<> Empty ruleをクリックします。

  4. 次のコードブロックをScriptボックスに追加します。新しいBitriseアプリのClient IDが必要になりますが、これはApplicationsページで取得できます。

    function mapSamlAttributes(user, context, callback) {
     if (context.clientID === '{your app's clientID'}')
       context.samlConfiguration.mappings = {
         "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier": "email"
       }; 
     }
     callback(null, user, context);
    }

  5. Save changesをクリックします。

関連情報