​

パート 1: Microsoft Entra ID で Enterprise アプリケーションを作成する

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

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

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

​

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

4. 作成した Windsurf アプリケーションで Set up single sign on をクリックし、SAML をクリックします。
5. Basic SAML Configuration の Edit をクリックします。
6. この Entra ID のタブは開いたまま、新しいタブで https://windsurf.com/team/settings の Windsurf Teams SSO settings を開きます。
7. Microsoft Entra ID の SAML 設定フォームで以下を設定します:
   • Identifier (Entity ID): Windsurf SSO settings page の SP Entity ID の値をコピー
   • Reply URL (Assertion Consumer Service URL): Windsurf SSO settings page の Callback URL の値をコピー
   • 画面上部の Save をクリック
8. 正しい氏名表示のためユーザー属性を構成します。Microsoft Entra ID の Attributes & Claims で Edit をクリックします。
9. Add new claim をクリックし、次の新規クレームを 2 件作成します:
   • First claim: Name = firstName, Source attribute = user.givenname
   • Second claim: Name = lastName, Source attribute = user.surname

​

パート 3: Windsurf ポータルで SSO 設定を構成する

10. Windsurf SSO settings page で以下を設定します:
    • Pick your SSO ID: チームのログインポータル用に一意の識別子を選択（後から変更不可）
    • IdP Entity ID: Microsoft Entra ID の Set up Windsurf → Microsoft Entra Identifier の値をコピー
    • SSO URL: Microsoft Entra ID の Login URL の値をコピー
    • X509 Certificate: Microsoft Entra ID から SAML certificate (Base64) をダウンロードし、ファイルを開いてテキスト内容をここに貼り付け
11. Windsurf ポータルで 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-----
値
------END CERTIFICATE------

• Microsoft Entra ID / Azure AD への管理者アクセス
• Windsurf への管理者アクセス
• Entra ID 上の既存の Windsurf アプリケーション（通常は既存の SSO アプリケーションから作成済み）

​

ステップ 1: 既存の Windsurf アプリケーションに移動

​

ステップ 2: SCIM プロビジョニングを設定

​

ステップ 3: SCIM プロビジョニングを構成

NOT([IsSoftDeleted])

• Okta の管理者アクセス
• Windsurf の管理者アクセス
• Okta 上の既存の Windsurf アプリケーション（通常は既存の SSO アプリケーションとして作成済み）

​

Step 1: 既存の Windsurf アプリケーションに移動する

​

Step 2: SCIM プロビジョニングを有効化する

• https://windsurf.com/team/settings にアクセスし、Other Settings の中の Service Key Configuration を開く
• Add Service Key をクリックして、キー名を設定する
• 表示された API キーをコピーし、Okta に戻って HTTP Header - Authorization に貼り付ける

​

Step 3: プロビジョニングを設定する

​

Step 4: グループプロビジョニングを設定する（任意）

​

グループの作成

curl -k -X POST https://server.codeium.com/scim/v2/Groups -d '{
"displayName": "<グループ名>",
"schemas": ["urn:ietf:params:scim:schemas:core:2.0:Group"]
}' -H "Authorization: Bearer <APIシークレットキー>" -H "Content-Type: application/scim+json"

​

グループメンバーを追加

curl -X PATCH https://server.codeium.com/scim/v2/Groups/<グループ名> -d '{"schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
"Operations":[
{
"op": "add",
"path":"members",
"value": [{"value": "<メールアドレス1>"}, {"value": "<メールアドレス2>"}]
}]}' -H "Authorization: Bearer <APIシークレットキー>" -H "Content-Type: application/scim+json"

​

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

curl -X PATCH https://server.codeium.com/scim/v2/Groups/<グループ名> -d '{"schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
"Operations":[
{
"op": "replace",
"path":"members",
"value": [{"value": "<メール1>"}, {"value": "<メール2>"}]
}]}' -H "Authorization: Bearer <APIシークレットキー>" -H "Content-Type: application/scim+json"

​

グループの削除

curl -X DELETE https://server.codeium.com/scim/v2/Groups/<グループ名> -H "Authorization: Bearer <APIシークレットキー>" -H "Content-Type: application/scim+json"

​

リストグループ

curl -X GET -H "Authorization: Bearer <APIシークレットキー>" "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/<ユーザーAPIキー> \
  -H 'Content-Type: application/scim+json' \
  -H 'Authorization: Bearer <APIシークレットキー>' \
  -d '{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [
      {
        "op": "replace",
        "path": "active",
        "value": false
      }
    ]
  }'

curl -X POST \
  https://server.codeium.com/scim/v2/Users \
  -H 'Content-Type: application/scim+json' \
  -H 'Authorization: Bearer <APIシークレットキー>' \
  -d '{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
    "userName": "<メールアドレス>",
    "displayName": "<氏名>",
    "active": true,
}'

curl -X PATCH \
  'https://<enterprise portal url>/_route/api_server/scim/v2/Users/<user api key>' \
    -H 'Authorization: Bearer <サービス キー>' \
    -H 'Content-Type: application/scim+json' \
    -d '{
      "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
      "Operations": [
        {
          "op": "Replace",
          "path": "displayName",
          "value": "<新しい名前>"
        }
      ]
   }'

​

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

​

前提条件

​

Windsurf 用に Duo を設定する

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

2. Team Settings の SSO に移動します

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

7. Windsurf ポータルの SP Identity ID の値をコピーし、Duo ポータルの Entity ID フィールドに貼り付けます。
8. Windsurf ポータルの Callback URL (Assertion Consumer Service URL) をコピーし、Duo ポータルの Assertion Consumer Service (ACS) URL フィールドに貼り付けます。
9. Duo ポータルで、次のとおり属性ステートメントを構成します:

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

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

​

前提条件

​

Windsurf 用に PingID を構成する

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

2. Team Settings の SSO に移動します

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

4. PingID で手動入力を選択し、以下の値で各フィールドを入力します:

• ACS URLs - Windsurf ポータルの Callback URL (Assertion Consumer Service URL) です。
• Entity ID - Windsurf ポータルの SP Entity ID です。

5. PingID の Issuer ID を Windsurf ポータルの IdP Entity ID にコピーします。
6. PingID の Single Signon Service の値を Windsurf ポータルの SSO URL にコピーします。
7. PingID から署名証明書を X509 PEM (.crt) でダウンロードし、ファイルを開いて内容を Windsurf ポータルの X509 Certificate に貼り付けます。

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

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

9. セットアップ／組織の要件に応じて、他のポリシーやアクセスを追加・編集します
10. テストできるよう、Windsurf ポータルで SAML ログインを有効化します。

11. テストが正常に完了したら、ログアウトして構いません。以後は、手順 3 で設定した SSO ID を使用してチーム／組織ページにアクセスする際に、SSO でサインインできます。