Como configurar o SCIM com o Microsoft Entra ID

Use SCIM para manter seus usuários do Calendly em sincronia com o Microsoft Entra ID (antigo Azure Active Directory). O SCIM pode adicionar, atualizar, desativar ou excluir automaticamente usuários com base no seu provedor de identidade (IdP).

Antes de começar

• Configure o Logon Único (SSO) SAML antes de configurar o SCIM.
• Você deve ser proprietário ou administrador do Calendly.
• Mantenha o Calendly e o Microsoft Entra ID abertos em janelas separadas durante a configuração.

Etapa 1 – Habilite o SCIM no Calendly.

1. Abra o Calendly.
2. Vá para a Central de administrador e selecione Login.
3. Na parte superior, selecione Provisionamento de Usuários.
4. Ative Impor SCIM para a minha organização.
5. Escolha quando o token deve expirar.
6. Selecione Gerar novo token de portador.
7. Selecione Copiar token. Salve — você só pode copiá-lo uma vez.

Etapa 2 – Configurar o SCIM no Microsoft Entra ID

1. Abra o portal do Microsoft Entra ID.
2. Vá para Aplicativos Empresariais.
3. Em Todos os Aplicativos, selecione o aplicativo usado para SAML SSO.
4. Na Barra Lateral, selecione Provisionamento.
5. No Menu Gerenciar, selecione Provisionamento novamente.
6. Defina o Modo de Provisionamento como Automático.
7. Cole o token do Calendly no campo Secret Token.
8. Copie o URL base do Calendly e cole-o no campo URL do Locatário.
9. Selecione Testar conexão.
   • Se falhar, tente copiar o token e o URL base novamente.
10. Selecione Salvar.

Etapa 3 – Definir mapeamentos de usuários

1. No Entra ID, vá para Mapeamentos.
2. Selecione Provisionar Grupos do Microsoft Entra ID.
   • Desative a opção Ativado e selecione Salvar e feche.
3. Selecione Provisionar Usuários do Microsoft Entra ID.
   • Certifique-se de Criar e Atualizar estão ativados.
   • Decida se deseja ativar Excluir:
     • Se ativado, os usuários excluídos perderão todos os dados do Calendly.
     • Se estiver desativado, os usuários serão desativados, mas podem ser reativados.
4. Em Mapeamentos de Atributos:
   • Mantenha userName, active e displayName.
   • Exclua todos os outros atributos.
5. Edite userName:
   • Altere a origem para mail.
   • Selecione OK.
6. Selecione Salvar e, em seguida, selecione Sim e feche a janela.

Etapa 4 – Iniciar o provisionamento

1. Vá para a seção Configurações.
2. (Opcional) Ative alertas de e-mail para falhas. Adicione os e-mails para receber alertas.
3. Em Escopo, escolha Sincronizar apenas usuários e grupos atribuídos.
4. Altere o status de provisionamento para Ativar.
5. Selecione Salvar.

Observação: a sincronização do SCIM é executada a cada 40 minutos. Você também pode iniciá-lo manualmente usando o Provision on demand.

Etapa 5 – Adicionar usuários ao Calendly

1. No Entra ID, volte ao aplicativo Calendly.
2. Selecione Usuários e grupos.
3. Selecione + Adicionar usuário/grupo.
4. Escolha seus usuários e selecione Atribuir.

Etapa 6 – Configurar atributos para mapeamento de grupo (opcional)

Se você quiser que o SCIM coloque os usuários em grupos do Calendly automaticamente:

1. No Entra ID:
   • Vá para Mostrar opções avançadas e selecione Editar lista de atributos.
   • Adicione uma nova linha:
     • Attribute: urn:ietf:params:scim:schemas:extension:Calendly:2.0:User:group
     • Type: String
2. Volte para a tabela de mapeamentos de atributos.
3. Selecione Adicionar novo mapeamento:
   • Escolha um atributo de origem (por exemplo, departamento).
   • Defina o atributo de destino como urn:ietf:params:scim:schemas:extension:Calendly:2.0:User:group.
   • Selecione OK e Salvar.

Etapa 7 – Associe usuários com grupos do Calendly (opcional)

Siga estas etapas para automatizar o provisionamento de grupos.