Você quer automatizar o provisionamento e desprovisionamento de usuários entre Okta e seu workspace do Notion para reduzir o trabalho manual de administração. O Notion suporta SCIM 2.0 para gerenciamento de identidade, e o Okta atua como provedor de identidade que envia alterações de usuários para o Notion. Este artigo explica como configurar a integração SCIM do Notion no Okta, definir mapeamentos de atributos e testar a conexão para que novos funcionários, mudanças de cargo e desligamentos sejam sincronizados automaticamente.
Principais Conclusões: Provisionamento SCIM entre Okta e Notion
- Settings > Members > Settings > SCIM Integration: Gere o token bearer SCIM que o Okta usará para conectar-se ao seu workspace do Notion.
- Okta Admin Console > Applications > Notion > Provisioning: Ative o SCIM e cole a URL base SCIM do Notion e o token nas configurações de provisionamento do Okta.
- Okta Admin Console > Profile Editor > Notion User: Mapeie atributos do Okta como email e displayName para os atributos SCIM correspondentes do Notion para garantir o fluxo correto de dados.
O que é Provisionamento SCIM e Por que Usá-lo com o Notion
SCIM significa System for Cross-domain Identity Management. É um padrão aberto que permite que provedores de identidade como o Okta criem, atualizem e excluam automaticamente contas de usuário em um provedor de serviços como o Notion. Sem SCIM, um administrador precisa adicionar manualmente cada usuário ao workspace do Notion e removê-los quando saem. Com SCIM, o Okta envia uma solicitação push para o Notion toda vez que um usuário é atribuído ao aplicativo Notion ou removido dele.
O Notion suporta SCIM 2.0 em seus planos Business e Enterprise. O recurso não está disponível nos planos Free ou Plus. Antes de começar, confirme que seu workspace do Notion está em um plano Business ou Enterprise e que você tem permissões de proprietário do workspace. Você também precisa de acesso de administrador do Okta com permissão para adicionar e configurar aplicativos.
A integração usa um token bearer gerado pelo Notion. O Okta usa esse token para autenticar todas as chamadas de API SCIM. O token nunca expira, mas você pode regenerá-lo na página de configurações SCIM do Notion, se necessário. A conexão é de saída do Okta para o Notion; o Okta inicia todas as solicitações de provisionamento.
Passos para Configurar o Provisionamento SCIM do Notion no Okta
Siga estes passos em ordem. Não pule a etapa de geração do token, pois o Okta precisa do token antes de ativar o provisionamento.
- Gerar o Token Bearer SCIM no Notion
Abra o Notion e vá para Settings > Members na barra lateral esquerda. Selecione a aba Settings, depois role até SCIM Integration. Clique em Generate Token. Copie a string do token que aparece. Armazene-o em um gerenciador de senhas seguro, pois você não poderá vê-lo novamente após fechar a caixa de diálogo. - Adicionar o Aplicativo Notion no Okta
Faça login no Okta Admin Console. Vá para Applications > Applications e clique em Add Application. Pesquise por Notion no catálogo de aplicativos. Selecione Notion e clique em Add. Na página General Settings, insira um nome de exibição para o aplicativo e clique em Done. - Ativar o Provisionamento SCIM no Okta
No Okta Admin Console, vá para Applications > Applications e clique no aplicativo Notion que você acabou de criar. Abra a aba Provisioning. Clique em Configure API Integration. Marque a caixa intitulada Enable API integration. Cole a URL base SCIM no campo API Token. A URL base SCIM é semprehttps://api.notion.com/v1/scim/v2. Cole o token bearer que você copiou do Notion no campo API Token. Clique em Test API Credentials. Uma mensagem de sucesso confirma a conexão. Clique em Save. - Configurar Recursos de Provisionamento
Ainda na aba Provisioning, clique em To App sob o título Settings. Clique em Edit. Marque as caixas para Create Users, Update User Attributes e Deactivate Users. Essas três opções habilitam o gerenciamento completo do ciclo de vida. Clique em Save. - Mapear Atributos do Okta para Atributos SCIM do Notion
Na aba Provisioning, vá para Attribute Mappings. Clique no título Mappings e selecione Okta User to Notion. O mapeamento padrão envia email para userName e displayName para displayName. Verifique se os seguintes mapeamentos existem: email mapeia para userName, displayName mapeia para displayName e name.givenName mapeia para name.givenName. Se algum mapeamento estiver faltando, clique em Add Mapping e selecione o atributo Okta correto e o atributo Notion. Clique em Save Mappings. - Atribuir Usuários ao Aplicativo Notion
Vá para Applications > Applications e clique no aplicativo Notion. Abra a aba Assignments. Clique em Assign e selecione Assign to People. Pesquise por um usuário de teste e clique em Assign. Confirme a atribuição. O Okta envia o usuário para o Notion em alguns minutos. Você pode forçar um push clicando no botão Push Now na aba Provisioning. - Verificar o Provisionamento no Notion
Abra o Notion e vá para Settings > Members. Na seção Members, confirme que o usuário atribuído aparece com o nome e email corretos. O usuário deve ter uma função Member ou Admin dependendo da atribuição do grupo Okta. Remova o usuário da atribuição do aplicativo Okta para testar o desprovisionamento. O usuário deve desaparecer da lista de membros do Notion em minutos.
Se o Provisionamento SCIM Falhar ou se Comportar de Forma Inesperada
Okta Retorna um Erro 401 Não Autorizado ao Testar Credenciais de API
Esse erro significa que o token bearer é inválido ou expirou. Os tokens do Notion não expiram, mas você pode ter copiado o token incorretamente. Regere o token no Notion e cole-o novamente no Okta. Certifique-se de que não há espaços extras antes ou depois da string do token. Se o erro persistir, confirme que seu workspace do Notion está em um plano Business ou Enterprise. O SCIM não está disponível nos planos Free ou Plus.
Usuário é Criado no Notion mas Mostra o Nome Errado
O mapeamento de atributos no Okta pode estar incorreto. Vá para a aba Provisioning e abra Attribute Mappings. Verifique se o atributo Okta displayName mapeia para o atributo Notion displayName e se name.givenName mapeia para name.givenName. Se você usar um atributo Okta personalizado para o nome completo do usuário, mapeie esse atributo personalizado em vez de displayName. Salve o mapeamento e envie o usuário novamente.
Usuário Não é Desprovisionado Após Remoção do Okta
Abra a aba Provisioning no aplicativo Notion do Okta e confirme que Deactivate Users está marcado. Se estiver marcado, verifique o log do sistema Okta para erros de provisionamento. Vá para Reports > System Log e filtre por tipo de evento application.provision.user_deactivate. Se o log mostrar sucesso mas o usuário ainda aparecer no Notion, aguarde até 10 minutos para a sincronização SCIM ser concluída. Você também pode desativar manualmente o usuário no Notion em Settings > Members.
Token SCIM Foi Acidentalmente Exposto
Regere o token imediatamente no Notion em Settings > Members > Settings > SCIM Integration. Clique em Generate Token novamente. O token antigo se torna inválido. Atualize o campo API Token nas configurações de provisionamento do Okta com o novo token e salve.
| Item | Notion Free / Plus | Notion Business / Enterprise |
|---|---|---|
| Suporte a SCIM 2.0 | Não disponível | Disponível |
| Geração de token bearer | Sem página de configurações SCIM | Settings > Members > SCIM Integration |
| Automação do ciclo de vida do usuário | Apenas manual | Automática via Okta |
| Controle de mapeamento de atributos | Nenhum | Editor de perfil do Okta |
| Desprovisionamento | Remoção manual | Automático na desativação do usuário no Okta |
Agora você pode provisionar e desprovisionar usuários do Notion automaticamente através do Okta sem tocar no painel de administração do Notion. Teste a integração com um pequeno grupo de usuários antes de implementar para toda a organização. Para controle avançado, use regras de grupo do Okta para atribuir o aplicativo Notion com base no departamento ou função, o que reduz o trabalho manual de atribuição.