SpotBooker SpotBooker Guide
Diretório

Sincronizar os utilizadores com SCIM

O seu diretório cria, atualiza e desativa ele próprio as contas SpotBooker: quem sai perde o acesso no próprio dia.

🔄

O início de sessão Microsoft ou SAML só atua quando alguém inicia sessão. Com o SCIM, é o seu diretório (Microsoft Entra ID, Okta ou qualquer ferramenta compatível com SCIM 2.0) que avisa o SpotBooker de cada entrada, alteração ou saída. O aprovisionamento está incluído na subscrição e disponível durante o teste gratuito. Só os administradores do seu espaço o configuram.

Passo a passo
1 Gere o token secreto

Clique em « Gerar um token » e copie-o de imediato: só é mostrado uma vez, o SpotBooker guarda apenas uma impressão digital. Depois, só ficam visíveis as datas de criação e de última utilização. Perdeu-o? Gere um novo: o anterior deixa logo de funcionar. « Revogar » corta o acesso do diretório.

2 Copie o URL do serviço

Termina em /scim/v2: https://spot-booker.app/scim/v2. O seu diretório pede-o com o nome « URL do inquilino », « Tenant URL » ou « Base URL ».

3 Ligue o seu diretório

No seu diretório, abra a aplicação SpotBooker (a do início de sessão, se a tiver) e ative o aprovisionamento automático. Cole o URL e o token, com autenticação por token de portador (« Bearer token » ou « Token secreto »), e teste a ligação. No Microsoft Entra ID, é a secção Aprovisionamento da aplicação empresarial; noutras ferramentas, o nome dos menus varia. Por fim, atribua as pessoas e os grupos a sincronizar.

4 Mantenha os atributos padrão

O SpotBooker lê o identificador (userName, muitas vezes o endereço de início de sessão), o endereço de email principal, o nome próprio, o apelido e o estado ativo ou inativo. Sem endereço de email, o userName substitui-o se tiver essa forma. As correspondências propostas por predefinição pelo seu diretório costumam servir.

5 Verifique as primeiras contas

As contas chegam à lista de utilizadores como membros, sem direitos de administração. Uma pessoa que já tinha conta no seu espaço com o mesmo endereço é retomada, não duplicada. A data de última utilização do token confirma que o seu diretório se ligou.

6 Ligue os grupos do diretório

Os grupos enviados pelo seu diretório aparecem com o número de membros. Ligue cada um a um grupo SpotBooker: os seus membros entram nele de imediato, e depois entram e saem ao ritmo das alterações do diretório. Um grupo não ligado é recebido mas não altera nenhum direito, e um grupo gerido à mão no SpotBooker nunca é alterado.

O SCIM mantém as contas atualizadas mas não liga ninguém: as contas que cria não têm palavra-passe conhecida. Combine-o com o início de sessão Microsoft, o início de sessão SAML ou o início de sessão LDAP para que os seus utilizadores entrem com as credenciais da organização.
Quando alguém sai do diretório
1 A conta é desativada de imediato

Assim que o seu diretório desativa ou retira a pessoa, ela deixa de poder iniciar sessão, por qualquer meio, e a sessão aberta fecha-se. Nada é apagado: as suas reservas mantêm-se.

2 Um alerta deixa-o decidir

Se tinha reservas futuras (confirmadas ou pendentes, ainda não iniciadas), os administradores veem no painel « Maria Martins saiu do diretório: 3 reservas futuras ». « Cancelar tudo » cancela essas reservas e liberta os recursos; o titular e os convidados são avisados por email, como num cancelamento a partir do planeamento. « Manter » deixa-as como estão, por exemplo quando um colega retoma os horários. A decisão fica registada e o alerta desaparece.

3 Um regresso reabre a conta

Se a pessoa voltar ao diretório, a conta é reativada automaticamente e o alerta ainda aberto fecha-se. A conta não se reativa à mão no SpotBooker: o diretório continua a ser a referência.

Salvaguardas: o último administrador ativo do seu espaço não pode ser desativado pelo diretório, pois ninguém o poderia gerir; nomeie primeiro outro administrador. Um endereço já usado noutro espaço SpotBooker não é retomado. As contas da equipa SpotBooker nunca são visíveis para o seu diretório.
Em caso de problema
O que vê O que fazer
O teste de ligação falha (erro 401) O token está errado, revogado ou foi substituído por um mais recente. Gere um novo e cole-o tal como está. Verifique também que o URL termina em /scim/v2.
Todos os pedidos recebem um erro 403 O teste gratuito terminou sem subscrição. O token e as definições são mantidos: a sincronização retoma logo que subscrever.
Uma pessoa não é criada (conflito, erro 409) O endereço já é usado por uma conta de outro espaço SpotBooker, ou o identificador por outra conta do seu espaço. Escreva-nos se a pessoa deve juntar-se ao seu espaço.
A desativação de um administrador é recusada (erro 400) É o último administrador ativo do seu espaço. Nomeie outro no SpotBooker e volte a lançar a sincronização.
Não aparece nenhum grupo O seu diretório ainda não enviou nenhum: atribua os grupos à aplicação e verifique que a sincronização de grupos está ativada. Aparecem após o ciclo seguinte.
Nenhum alerta após uma saída A pessoa não tinha reservas futuras: a conta está desativada e não há mais nada a decidir. Uma reserva já iniciada não conta.

Experimente o SpotBooker grátis — 14 dias, sem cartão de crédito

Crie a sua conta e configure os seus próprios espaços seguindo este guia.

Começar o meu teste grátis
Todos os guias
Reservar Reservar Agenda