​

パート 1: Microsoft Entra ID で Enterprise Application を作成する

1. Microsoft Entra ID で、Add をクリックし、次に Enterprise Application をクリックします。

2. Create your own application をクリックします。

3. アプリケーション名を Devin Desktop にし、Integrate any other application you don’t find in the gallery を選択してから、Create をクリックします。

​

パート 2: Microsoft Entra ID で SAML とユーザー属性を設定する

4. 新しく作成した Devin Desktop アプリケーションで、Set up single sign on をクリックし、次に SAML をクリックします。
5. Basic SAML Configuration の Edit をクリックします。
6. この Entra ID のタブは開いたままにして、新しいタブを開き、https://windsurf.com/team/settings の Devin Desktop Teams SSO settings に移動します。
7. Microsoft Entra ID の SAML 設定フォームで、次のように設定します:
   • Identifier (Entity ID): Devin Desktop SSO settings page から SP Entity ID の値をコピーします
   • Reply URL (Assertion Consumer Service URL): Devin Desktop SSO settings page から Callback URL の値をコピーします
   • 上部の Save をクリックします
8. 名前が正しく表示されるよう、ユーザー属性を設定します。Microsoft Entra ID の Attributes & Claims で、Edit をクリックします。
9. Add new claim をクリックして、次の claim を 2 つ作成します:
   • 1 つ目の claim: Name = firstName, Source attribute = user.givenname
   • 2 つ目の claim: Name = lastName, Source attribute = user.surname

​

パート 3: Devin Desktop Portal で SSO 設定を行う

10. Devin Desktop SSO settings page で、次のように設定します:
    • Pick your SSO ID: チームのログインポータル用に一意の識別子を選択します (これは後から変更できません)
    • IdP Entity ID: Microsoft Entra ID の Set up Devin Desktop → Microsoft Entra Identifier から値をコピーします
      IdP Entity ID の URL は末尾が / で終わっている必要があります (例: https://sts.windows.net/{tenant-id}/) 。URL に末尾のスラッシュが含まれていない場合は、手動で追加してください。
    • SSO URL: Microsoft Entra ID から Login URL の値をコピーします
    • X509 Certificate: Microsoft Entra ID から SAML certificate (Base64) をダウンロードし、ファイルを開いて、そのテキスト内容をここに貼り付けます
11. Devin Desktop portal で、Enable Login with SAML をクリックし、次に Save をクリックします。
12. 設定をテストする: Test Login をクリックし、SSO 設定が想定どおりに機能することを確認します。

​

IDP アプリケーションを設定する

• Single sign-on URL を https://auth.windsurf.com/__/auth/handler に設定
• Audience URI (SP Entity ID) を www.codeium.com に設定
• NameID format を EmailAddress に設定
• Application username を Email に設定

​

Okta を SAML プロバイダーとして登録する

• https://windsurf.com/team/settings を開き、Configure SAML をクリックします
• Okta のアプリケーションページで ‘Issuer’ の後ろにあるテキストをコピーし、Idp Entity ID に貼り付けます
• Okta のアプリケーションページで ‘Sign on URL’ の後ろにあるテキストをコピーし、SSO URL に貼り付けます
• Signing Certificate をダウンロードし、X509 certificate に貼り付けます
• Enable Login with SAML をチェックしてから Save をクリックします
• Test Login ボタンでログインをテストします。成功メッセージが表示されるはずです:

​

注意事項

​

トラブルシューティング

​

Login with SAML config failed: Firebase: Error (auth/operation-not-allowed)

​

Login with SAML config failed: Firebase: SAML Response <Issuer> mismatch. (auth/invalid-credential)

​

Failed to verify the signature in samlresponse

-----BEGIN CERTIFICATE-----
value
------END CERTIFICATE------

• Microsoft Entra ID / Azure AD への管理者アクセス
• Devin Desktopへの管理者アクセス
• Entra ID 上の既存の Devin Desktop Application (通常は既存の SSO (シングルサインオン) アプリケーション)

​

ステップ1: SCIM権限を持つロールを作成する

1. Windsurf チーム設定に移動します
2. “その他の設定” で、ロール管理 の横の 設定 をクリックします
3. 「Add Role」をクリックし、名前を”SCIM Provisioning”に設定します
4. 以下の権限を追加してください:
   • Team ユーザーの閲覧
   • Team ユーザーの更新
   • Team ユーザーの削除
5. Save をクリックします

​

ステップ2: 既存のDevinデスクトップアプリケーションに移動する

​

ステップ3: SCIMプロビジョニングの設定

​

ステップ4: SCIMプロビジョニングの設定

NOT([IsSoftDeleted])

• Okta への Admin アクセス
• Devin Desktop への Admin アクセス
• Okta 上に既存の Devin Desktop Application があること (通常は既存の SSO アプリケーション)

​

Step 1: 既存の Devin Desktop Application に移動する

​

Step 2: SCIM Provisioning を有効にする

• https://windsurf.com/team/settings にアクセスし、Service Key Configuration を開く
• Configure をクリックし、次に Add Service Key をクリックして、APIキーに名前を付ける
• APIキーをコピーし、Okta に戻って HTTP Header - Authorization に貼り付ける

​

Step 3: Provisioning を設定する

​

Step 4: Group Provisioning を設定する (任意)

​

グループの作成

curl -k -X POST https://server.codeium.com/scim/v2/Groups -d '{
"displayName": "<group name>",
"schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"]
}' -H "Authorization: Bearer <api secret key>" -H "Content-Type: application/scim+json"

​

グループメンバーの追加

curl -X PATCH https://server.codeium.com/scim/v2/Groups/<group name> -d '{"schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
"Operations":[
{
"op": "add",
"path":"members",
"value": [{"value": "<email 1>"}, {"value": "<email 2>"}]
}]}' -H "Authorization: Bearer <api secret key>" -H "Content-Type: application/scim+json"

​

グループメンバーの置き換え

curl -X PATCH https://server.codeium.com/scim/v2/Groups/<group name> -d '{"schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
"Operations":[
{
"op": "replace",
"path":"members",
"value": [{"value": "<email 1>"}, {"value": "<email 2>"}]
}]}' -H "Authorization: Bearer <api secret key>" -H "Content-Type: application/scim+json"

​

グループの削除

curl -X DELETE https://server.codeium.com/scim/v2/Groups/<group name> -H "Authorization: Bearer <api secret key>" -H "Content-Type: application/scim+json"

​

グループの一覧表示

curl -X GET -H "Authorization: Bearer <api secret key>" "https://server.codeium.com/scim/v2/Groups"

​

グループ内のユーザーを一覧表示する

curl -X GET -H "Authorization: Bearer <api secret key>" "https://server.codeium.com/scim/v2/Groups/<group_id>"

​

ユーザーAPI

curl -X PATCH \
  https://server.codeium.com/scim/v2/Users/<user api key> \
  -H 'Content-Type: application/scim+json' \
  -H 'Authorization: Bearer <api secret key>' \
  -d '{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
      {
        "op": "replace",
        "path": "active",
        "value": false
      }
    ]
  }'

curl -X PATCH \
  https://server.codeium.com/scim/v2/Users/<user api key> \
  -H 'Content-Type: application/scim+json' \
  -H 'Authorization: Bearer <api secret key>' \
  -d '{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
      {
        "op": "replace",
        "path": "cliActive",
        "value": false
      }
    ]
  }'

curl -X POST \
  https://server.codeium.com/scim/v2/Users \
  -H 'Content-Type: application/scim+json' \
  -H 'Authorization: Bearer <api secret key>' \
  -d '{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
    "userName": "<email>",
    "displayName": "<full name>",
    "active": true
}'

curl -X PATCH \
  'https://<enterprise portal url>/_route/api_server/scim/v2/Users/<user api key>' \
    -H 'Authorization: Bearer <service key>' \
    -H 'Content-Type: application/scim+json' \
    -d '{
      "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
      "Operations": [
        {
          "op": "Replace",
          "path": "displayName",
          "value": "<new name>"
        }
      ]
   }'

​

APIシークレットキーの作成

​

前提条件

​

Devin Desktop 向けに Duo を設定する

1. Applications に移動し、Generic SAML service provider を追加します

2. チーム設定 の SSO (シングルサインオン) に移動します

3. 初めて SAML を有効にする際は、SSO ID の設定が必要です。この ID は後から変更できません。 組織名またはチーム名を英数字のみで設定することを推奨します。
4. Duo ポータルから Entity ID の値をコピーし、Devin Desktop ポータルの IdP Entity ID フィールドに貼り付けます。
5. Duo ポータルから Single Sign-On URL の値をコピーし、Devin Desktop ポータルの SSO URL フィールドに貼り付けます。
6. Duo ポータルから証明書の値をコピーし、Devin Desktop ポータルの X509 Certificate フィールドに貼り付けます

7. Devin Desktop ポータルから SP Identity ID の値をコピーし、Duo ポータルの Entity ID フィールドに貼り付けます。
8. Devin Desktop ポータルから Callback URL (Assertion Consumer Service URL) をコピーし、Duo ポータルの Assertion Consumer Service (ACS) URL フィールドに貼り付けます。
9. Duo ポータルで、属性ステートメントを次のように設定します。

10. テストできるように、Devin Desktop ポータルで SAML ログインを有効にします。

11. テストが正常に完了したら、ログアウトしてかまいません。これで、手順 3 で設定した SSO ID を使用してチーム/組織ページにアクセスする際に、SSO サインインを利用できるようになります。

​

前提条件

​

Devin Desktop 用に PingID を設定する

1. Applications に移動し、Devin Desktop を SAML アプリケーションとして追加します

2. チーム設定の SSO に移動します

3. 初めて SAML を有効にする際は、SSO ID を設定する必要があります。この ID は後から変更できません。

4. PingID で構成を手動入力するオプションを選択し、以下の値を各項目に入力します。

• ACS URLs - Devin Desktop ポータルの Callback URL (Assertion Consumer Service URL) を入力します。
• Entity ID - Devin Desktop ポータルの SP Entity ID を入力します。

5. PingID の Issuer ID を、Devin Desktop ポータルの IdP Entity ID にコピーします。
6. PingID の Single Signon Service の値を、Devin Desktop ポータルの SSO URL にコピーします。
7. PingID から Signing Certificate を X509 PEM (.crt) 形式でダウンロードし、ファイルを開いてその内容を Devin Desktop ポータルの X509 Certificate にコピーします。

8. 属性マッピングで、以下が設定されていることを確認します。

• saml_subject - Email Address
• firstName - Given Name
• lastName - Family Name

9. 構成や組織に応じて、必要なその他のポリシーやアクセス設定を追加または編集します
10. Devin Desktop ポータルで SAML ログインを有効にし、テストできるようにします。

11. テストが正常に完了したら、ログアウトできます。以降は、手順 3 で設定した SSO ID を使ってチーム/組織ページにアクセスする際に、SSO (シングルサインオン) でサインインできます。