このガイドは、ネイティブ連携である Microsoft Entra ID (OIDC) や Okta (OIDC) ではなく SAML を使用したいお客様向けです。一般的には、可能な場合はネイティブの OIDC 連携を利用することを推奨しますが、状況によっては SAML SSO の方が適している場合もあります。
必要なもの
Devin 向けに SAML SSO (シングルサインオン) をセットアップするには、次の情報が必要です。これらは以下のセットアップ手順の中で順次収集し、ステップ 4 で接続を追加する際に使用します。- サインイン URL - IdP の SAML SSO エンドポイント (例:
https://idp.example.com/sso/saml) - X509 Signing Certificate - IdP が SAML アサーションに署名するために使用する公開証明書
- Identity Provider Domains - この IdP を通じて認証を行う、すべての会社のメールドメイン (例:
example.com,subsidiary.example.com)
セットアップ手順
ステップ 1: IdP で SAML アプリケーションを作成する
ご利用のアイデンティティプロバイダーの管理コンソールで、次の設定を使用して新しい SAML 2.0 アプリケーションを作成します。ステップ 2: SAML 属性を設定する
IdP が SAML アサーション内で次の属性を送信するよう構成してください:Devin はユーザーを識別するために
nameidentifier 属性を使用します。多くの IdP は SAML の Name ID 値からこれを自動的に設定します。IdP が nameidentifier を個別の属性として送信しない場合は、ステップ 1 で Name ID Value がユーザーのメールアドレスになるように設定してください。ステップ 3: グループアサーションを構成する (IdP グループに必須)
IdP グループ同期を有効にするには、SAML アプリケーションで グループ属性 を構成します:Devin は次の SAML 属性名からグループメンバーシップを読み取ります。いずれかの属性名を使用してください:
http://schemas.xmlsoap.org/claims/Grouphttp://schemas.microsoft.com/ws/2008/06/identity/claims/groupsgroupsmemberOf
SAML を使用した Microsoft Entra ID
ネイティブな OIDC 連携ではなく SAML を使用して Microsoft Entra ID を利用している場合は、次の手順を実行します。- Azure ポータルで、Enterprise Applications > 対象の SAML アプリ > Single sign-on の順に移動します
- Attributes & Claims で Add a group claim をクリックします
- Groups assigned to the application (推奨) または All groups を選択します
- Source attribute を、ご利用の環境に適した値 (例:
sAMAccountNameまたはDisplay name) に設定します - Azure が生成する Claim name (
http://schemas.microsoft.com/ws/2008/06/identity/claims/groups) は変更せず、そのまま使用します
その他の SAML アイデンティティプロバイダー
その他の IdP (ADFS、Ping Identity、OneLogin など) の場合:- SAML アプリケーションの設定にグループ属性ステートメントを追加します
- ユーザーのグループメンバーシップを送信するように設定します
- 属性名には、上記に挙げた名前のいずれかを使用します
ステップ 4: 接続を追加する
接続を追加するために、次の情報を用意します。- サインイン URL (例:
https://idp.example.com/sso/saml) - 署名証明書 (PEM) (PEM 形式でエンコードされた公開証明書)
- メールドメイン (この IdP で使用するすべてのメールドメイン)
ステップ 5: 設定を完了する
connection name (sso-...) は、SSO connections の該当行に表示されます。以下の URL からメタデータをダウンロードしてください。メタデータには Entity ID (entityID) が含まれています。SAML アプリケーションの Entity ID / Audience URI にこの値を設定してください。
Devin は署名付きの SAML 認証リクエストを送信します。SAML メタデータファイルは次の URL から取得できます:このメタデータを IdP にインポートして、信頼関係の設定を完了し、リクエスト署名の検証を有効にしてください。
セットアップの検証
Entity ID を更新したら、次の手順を実行します。- Devin Enterprise の URL (例:
https://<your_subdomain>.devinenterprise.com) にアクセスします - ログインフローを開始するために Sign in with SAML (または同等の SSO (シングルサインオン) ボタン) をクリックします
- IdP のログインページにリダイレクトされるはずです
- 認証後、Devin Enterprise の組織に遷移するはずです
- Devin の Webアプリで Settings > Membership に移動し、Groups (IdP) タブを選択します
- 少なくとも 1 人のグループメンバーがログインした後、IdP グループが一覧表示されているはずです
- グループはログインのたびに同期されるため、IdP 側でのメンバーシップの変更は、ユーザーが次回サインインした際に反映されます
IdP グループはユーザーのログイン時に取得されるため、グループメンバーシップの変更を反映させるには再認証が必要です。グループベースのアクセス制御の設定の詳細については、IdP Group Integration を参照してください。

