​

Parte 1: Criar um aplicativo Enterprise no Microsoft Entra ID

1. No Microsoft Entra ID, clique em Adicionar e, em seguida, em Aplicativo Enterprise.

2. Clique em Criar seu próprio aplicativo.

3. Dê ao aplicativo o nome Devin Desktop, selecione Integrar qualquer outro aplicativo que você não encontrar na galeria e, em seguida, clique em Criar.

​

Parte 2: Configurar SAML e os atributos do usuário no Microsoft Entra ID

4. No seu novo aplicativo Devin Desktop, clique em Configurar logon único e depois em SAML.
5. Clique em Editar em Configuração básica de SAML.
6. Mantenha esta aba do Entra ID aberta e abra uma nova aba para acessar as Configurações de SSO do Teams do Devin Desktop em https://windsurf.com/team/settings.
7. No formulário de configuração SAML do Microsoft Entra ID:
   • Identificador (ID da Entidade): copie o valor de SP Entity ID da página de configurações de SSO do Devin Desktop
   • URL de Resposta (URL do Serviço do Consumidor de Asserção): copie o valor de Callback URL da página de configurações de SSO do Devin Desktop
   • Clique em Salvar na parte superior
8. Configure os atributos do usuário para exibir o nome corretamente. No Microsoft Entra ID, em Atributos e claims, clique em Editar.
9. Crie 2 novas claims clicando em Adicionar nova claim para cada uma:
   • Primeira claim: Name = firstName, Source attribute = user.givenname
   • Segunda claim: Name = lastName, Source attribute = user.surname

​

Parte 3: Configurar as Configurações de SSO no portal do Devin Desktop

10. Na página de configurações de SSO do Devin Desktop, ative o controle Configurações de SAML para que os campos possam ser editados e, em seguida, preencha:
    • Escolha seu ID de SSO: escolha um identificador exclusivo para o portal de login da sua equipe (isso não poderá ser alterado depois)
    • ID da Entidade do IdP: copie o valor do Microsoft Entra ID em Configurar o Devin Desktop → Identificador do Microsoft Entra
      A URL do ID da Entidade do IdP deve terminar com uma / no final (por exemplo, https://sts.windows.net/{tenant-id}/). Se a URL não incluir a barra final, adicione-a manualmente.
    • URL de SSO: copie o valor de Login URL do Microsoft Entra ID
    • Certificado X509: baixe o certificado SAML (Base64) do Microsoft Entra ID, abra o arquivo e cole aqui o conteúdo do texto
11. Teste a configuração: no portal do Devin Desktop, clique em Testar para verificar se a configuração de SSO funciona como esperado.
12. Depois que o teste for bem-sucedido, clique em Salvar para aplicar a configuração. O botão Salvar só aparece após um teste bem-sucedido.

​

Configurar o aplicativo do IDP

• Single sign-on URL como https://auth.windsurf.com/__/auth/handler
• Audience URI (SP Entity ID) como www.codeium.com
• Formato de NameID como EmailAddress
• Nome de usuário do aplicativo como Email

​

Registrar o Okta como provedor SAML

• Abra https://windsurf.com/team/settings e clique em Configure em SSO and SAML Configuration
• Ative o controle SAML Settings para que os campos possam ser editados
• Copie o texto após ‘Issuer’ na página do aplicativo do Okta e cole em Idp Entity ID
• Copie o texto após ‘Sign on URL’ na página do aplicativo do Okta e cole em SSO URL
• Baixe o Signing Certificate e cole em X509 certificate
• Teste o login com o botão Test. Você deverá ver uma mensagem de sucesso:

• Clique em Save para aplicar a configuração. O botão Save só aparece após um teste bem-sucedido.

​

Observações

​

Solução de problemas

​

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------

• Acesso administrativo ao Microsoft Entra ID
• Acesso de administrador ao Devin Desktop
• Um aplicativo de desktop existente do Devin no Entra ID (normalmente do seu aplicativo de SSO existente)

​

Etapa 1: Criar uma função com permissões SCIM

1. Acesse Configurações da equipe do Windsurf
2. Em “Outras configurações”, clique em Configurar ao lado de Gerenciamento de funções
3. Clique em Adicionar função e dê a ela o nome de “SCIM Provisioning”
4. Adicione as seguintes permissões:
   • Teams Read-Only
   • Atualização de Teams
   • Exclusão de Teams
5. Clique em Salvar

​

Etapa 2: Acesse o aplicativo existente do Devin Desktop

​

Etapa 3: Configurar o provisionamento SCIM

​

Etapa 4: Configurar o Provisionamento SCIM

NOT([IsSoftDeleted])

• Acesso de administrador ao Okta
• Acesso de administrador ao Devin Desktop
• Um app existente do Devin Desktop no Okta (normalmente o seu app de SSO existente)

​

Etapa 1: Navegue até o app existente do Devin Desktop

​

Etapa 2: Ativar o provisionamento SCIM

• https://windsurf.com/team/settings e ir até Service Key Configuration
• Clique em Configure, depois em Add Service Key, e dê um nome à sua Chave de API
• Copie a Chave de API, volte para o Okta e cole em HTTP Header - Authorization

​

Etapa 3: Configurar o provisionamento

​

Etapa 4: Configurar o provisionamento de grupos (Opcional)

​

Criar Grupo

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"

​

Adicionar Membros ao Grupo

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"

​

Substituir membros do grupo

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"

​

Excluir Grupo

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

​

Grupo de Lista

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

​

Listar Usuários em um Grupo

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

​

APIs de Usuário

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 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": "acuCycleLimit",
        "value": 100
      }
    ]
  }'

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": "remove",
        "path": "acuCycleLimit"
      }
    ]
  }'

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>"
        }
      ]
   }'

​

Criando uma Chave Secreta de API

​

Pré-requisitos

​

Configurar o Duo para o Devin Desktop

1. Acesse Applications e adicione um provedor de serviço SAML genérico

2. Acesse SSO em Configurações da equipe

3. Ao ativar o SAML pela primeira vez, será necessário configurar seu ID de SSO. Você não poderá alterá-lo depois. É recomendável defini-lo como o nome da sua organização ou equipe, usando apenas caracteres alfanuméricos.
4. Copie o valor de Entity ID do portal do Duo e cole-o no campo IdP Entity ID no portal do Devin Desktop.
5. Copie o valor de Single Sign-On URL do portal do Duo e cole-o no campo SSO URL no portal do Devin Desktop.
6. Copie o valor do certificado do portal do Duo e cole-o no campo X509 Certificate no portal do Devin Desktop

7. Copie o valor de SP Identity ID do portal do Devin Desktop e cole-o no campo Entity ID no portal do Duo.
8. Copie a Callback URL (Assertion Consumer Service URL) do portal do Devin Desktop e cole-a no campo Assertion Consumer Service (ACS) URL no portal do Duo.
9. No portal do Duo, configure as declarações de atributo da seguinte forma:

10. Ative o login SAML no portal do Devin Desktop para poder testá-lo.

11. Quando o teste for concluído com sucesso, você poderá encerrar a sessão. Agora você já pode usar o login por SSO ao acessar a página da sua equipe/organização com o ID de SSO configurado na etapa 3.

​

Pré-requisitos

​

Configurar o PingID para o Devin Desktop

1. Vá até Applications e adicione o Devin Desktop como um aplicativo SAML

2. Vá até SSO em Configurações da equipe

3. Ao ativar o SAML pela primeira vez, será necessário configurar seu ID de SSO. Você não poderá alterá-lo depois.

4. No PingID, escolha inserir a configuração manualmente e preencha os campos com os seguintes valores:

• ACS URLs - este é o Callback URL (Assertion Consumer Service URL) do portal do Devin Desktop.
• Entity ID - este é o SP Entity ID do portal do Devin Desktop.

5. Copie o Issuer ID do PingID para o valor IdP Entity ID no portal do Devin Desktop.
6. Copie o valor Single Signon Service do PingID para o valor SSO URL no portal do Devin Desktop.
7. Baixe o Signing Certificate do PingID como X509 PEM (.crt), abra o arquivo e copie seu conteúdo para o valor X509 Certificate no portal do Devin Desktop.

8. Nos mapeamentos de atributos, certifique-se de mapear:

• saml_subject - Endereço de e-mail
• firstName - Nome
• lastName - Sobrenome

9. Adicione/edite quaisquer outras políticas e acessos conforme exigido pela sua configuração/organização
10. Ative o login SAML no portal do Devin Desktop para testá-lo.

11. Quando o teste for concluído com sucesso, você poderá fazer logout. Agora você pode usar o login com SSO ao acessar a página da sua equipe/organização com o ID de SSO que configurou na etapa 3.