Partilhar via

Tutorial: Integração do Microsoft Entra SSO com o TimeOffManager

  • Artigo

Neste tutorial, você aprenderá como integrar o TimeOffManager ao Microsoft Entra ID. Ao integrar o TimeOffManager com o Microsoft Entra ID, você pode:

  • Controle no Microsoft Entra ID quem tem acesso ao TimeOffManager.
  • Permita que seus usuários entrem automaticamente no TimeOffManager com suas contas do Microsoft Entra.
  • Gerencie suas contas em um local central.

Pré-requisitos

Para começar, você precisa dos seguintes itens:

  • Uma assinatura do Microsoft Entra. Se não tiver uma subscrição, pode obter uma conta gratuita.
  • Assinatura habilitada para logon único (SSO) do TimeOffManager.
  • Junto com o Cloud Application Administrator, o Application Administrator também pode adicionar ou gerenciar aplicativos no Microsoft Entra ID. Para obter mais informações, veja Funções incorporadas do Azure.

Descrição do cenário

Neste tutorial, você configura e testa o Microsoft Entra SSO em um ambiente de teste.

  • O TimeOffManager suporta SSO iniciado pelo IDP .

  • O TimeOffManager suporta o provisionamento de usuários Just In Time .

Nota

O identificador deste aplicativo é um valor de cadeia de caracteres fixo para que apenas uma instância possa ser configurada em um locatário.

Para configurar a integração do TimeOffManager no Microsoft Entra ID, você precisa adicionar o TimeOffManager da galeria à sua lista de aplicativos SaaS gerenciados.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
  2. Navegue até Identity>Applications>Enterprise applications>Novo aplicativo.
  3. Na seção Adicionar da galeria, digite TimeOffManager na caixa de pesquisa.
  4. Selecione TimeOffManager no painel de resultados e adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

Como alternativa, você também pode usar o Assistente de Configuração de Aplicativo Empresarial. Neste assistente, você pode adicionar um aplicativo ao seu locatário, adicionar usuários/grupos ao aplicativo, atribuir funções, bem como percorrer a configuração do SSO. Saiba mais sobre os assistentes do Microsoft 365.

Configurar e testar o Microsoft Entra SSO para TimeOffManager

Configure e teste o Microsoft Entra SSO com o TimeOffManager usando um usuário de teste chamado B.Simon. Para que o SSO funcione, você precisa estabelecer uma relação de vínculo entre um usuário do Microsoft Entra e o usuário relacionado no TimeOffManager.

Para configurar e testar o Microsoft Entra SSO com o TimeOffManager, execute as seguintes etapas:

  1. Configure o Microsoft Entra SSO - para permitir que seus usuários usem esse recurso.
    1. Crie um usuário de teste do Microsoft Entra - para testar o logon único do Microsoft Entra com B.Simon.
    2. Atribua o usuário de teste do Microsoft Entra - para permitir que B.Simon use o logon único do Microsoft Entra.
  2. Configure o SSO do TimeOffManager - para definir as configurações de logon único no lado do aplicativo.
    1. Criar usuário de teste do TimeOffManager - para ter um equivalente de B.Simon no TimeOffManager vinculado à representação do usuário do Microsoft Entra.
  3. Teste SSO - para verificar se a configuração funciona.

Configurar o Microsoft Entra SSO

Siga estas etapas para habilitar o Microsoft Entra SSO.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.

  2. Navegue até Identity>Applications>Enterprise applications>TimeOffManager>Single sign-on.

  3. Na página Selecione um método de logon único, selecione SAML.

  4. Na página Configurar logon único com SAML, clique no ícone de lápis para Configuração Básica de SAML para editar as configurações.

    Screenshot shows to edit Basic S A M L Configuration.

  5. Na seção Configuração Básica do SAML, execute a seguinte etapa:

    Na caixa de texto URL de resposta, digite uma URL usando o seguinte padrão:https://www.timeoffmanager.com/cpanel/sso/consume.aspx?company_id=<companyid>

    Nota

    Este valor não é real. Atualize esse valor com a URL de resposta real. Você pode obter esse valor na página Configurações de Logon Único, que é explicada posteriormente no tutorial ou na equipe de suporte do TimeOffManager. Você também pode consultar os padrões mostrados na seção Configuração Básica de SAML.

  6. O aplicativo TimeOffManager espera as asserções SAML em um formato específico, o que requer que você adicione mapeamentos de atributos personalizados à sua configuração de atributos de token SAML. A captura de tela a seguir mostra a lista de atributos padrão.

    Screenshot shows the image of TimeOffManager application.

  7. Além disso, o aplicativo TimeOffManager espera que mais alguns atributos sejam passados de volta na resposta SAML, que são mostrados abaixo. Esses atributos também são pré-preenchidos, mas você pode revisá-los de acordo com sua necessidade.

    Nome Atributo de origem
    Nome próprio Usuário.givenname
    Apelido Usuário.sobrenome
    Correio Eletrónico Usuário.mail

  8. Na página Configurar logon único com SAML, na seção Certificado de Assinatura SAML, localize Certificado (Base64) e selecione Download para baixar o certificado e salvá-lo em seu computador.

    Screenshot shows the Certificate download link.

  9. Na seção Configurar TimeOffManager, copie o(s) URL(s) apropriado(s) com base em sua necessidade.

    Screenshot shows to copy appropriate configuration U R L.

Criar um usuário de teste do Microsoft Entra

Nesta seção, você criará um usuário de teste chamado B.Simon.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um Administrador de Usuário.
  2. Navegue até Identidade>de usuários Todos os usuários.>
  3. Selecione Novo usuário Criar novo usuário>, na parte superior da tela.
  4. Nas propriedades do usuário , siga estas etapas:
    1. No campo Nome para exibição , digite B.Simon.
    2. No campo Nome principal do usuário, digite o username@companydomain.extensionarquivo . Por exemplo, B.Simon@contoso.com.
    3. Marque a caixa de seleção Mostrar senha e anote o valor exibido na caixa Senha .
    4. Selecione Rever + criar.
  5. Selecione Criar.

Atribuir o usuário de teste do Microsoft Entra

Nesta seção, você permitirá que B.Simon use o logon único concedendo acesso ao TimeOffManager.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
  2. Navegue até Identity>Applications>Enterprise applications>TimeOffManager.
  3. Na página de visão geral do aplicativo, localize a seção Gerenciar e selecione Usuários e grupos.
  4. Selecione Adicionar usuário e, em seguida, selecione Usuários e grupos na caixa de diálogo Adicionar atribuição .
  5. Na caixa de diálogo Usuários e grupos, selecione B.Simon na lista Usuários e clique no botão Selecionar na parte inferior da tela.
  6. Se você estiver esperando qualquer valor de função na asserção SAML, na caixa de diálogo Selecionar função, selecione a função apropriada para o usuário na lista e clique no botão Selecionar na parte inferior da tela.
  7. Na caixa de diálogo Adicionar atribuição, clique no botão Atribuir.

Configurar o SSO do TimeOffManager

  1. Em uma janela diferente do navegador da Web, entre no site da empresa TimeOffManager como administrador.

  2. Vá para > Opções > de Conta Configurações de Logon Único.

    Screenshot shows Single Sign-On Settings selected from Account Options.

  3. Na seção Configurações de Logon Único, execute as seguintes etapas:

    Screenshot shows the Single Sign-On Settings section where you can enter the values described.

    a. Abra o certificado codificado em base 64 no bloco de notas, copie o conteúdo dele para a área de transferência e cole todo o certificado na caixa de texto Certificado X.509.

    b. Na caixa de texto Emissor de Idp, cole o valor de Microsoft Entra Identifier..

    c. Na caixa de texto URL do ponto de extremidade do IdP, cole o valor de URL de login..

    d. Como Impor SAML, selecione Não.

    e. Como Auto-Create Users, selecione Yes.

    f. Na caixa de texto URL de Logout, cole o valor de URL de Logout..

    g. clique em Salvar alterações.

  4. Na página Configurações de Logon Único, copie o valor da URL do Serviço ao Consumidor de Asserção e cole-o na caixa de texto URL de Resposta na seção Configuração Básica de SAML no portal do Azure.

    Screenshot shows the Assertion Consumer Service U R L link.

Criar usuário de teste do TimeOffManager

Nesta seção, um usuário chamado Brenda Fernandes é criado no TimeOffManager. O TimeOffManager oferece suporte ao provisionamento de usuários just-in-time, que é habilitado por padrão. Não há nenhum item de ação para você nesta seção. Se um usuário ainda não existir no TimeOffManager, um novo será criado após a autenticação.

Nota

Você pode usar qualquer outra ferramenta de criação de conta de usuário do TimeOffManager ou APIs fornecidas pelo TimeOffManager para provisionar contas de usuário do Microsoft Entra.

SSO de teste

Nesta seção, você testa sua configuração de logon único do Microsoft Entra com as seguintes opções.

  • Clique em Testar este aplicativo e você deve estar automaticamente conectado ao TimeOffManager para o qual você configurou o SSO.

  • Você pode usar o Microsoft My Apps. Ao clicar no bloco TimeOffManager em Meus Aplicativos, você deve estar automaticamente conectado ao TimeOffManager para o qual configurou o SSO. Para obter mais informações, consulte Microsoft Entra My Apps.

Próximos passos

Depois de configurar o TimeOffManager, você pode impor o controle de sessão, que protege a exfiltração e a infiltração de dados confidenciais da sua organização em tempo real. O controle de sessão se estende do Acesso Condicional. Saiba como impor o controlo de sessão com o Microsoft Cloud App Security.