Tutorial: Configurar o Zendesk para provisionamento automático do usuárioTutorial: Configure Zendesk for automatic user provisioning

Este tutorial demonstra as etapas a serem executadas no zendesk e no Azure Active Directory (Azure AD) para configurar o Azure AD para provisionar e desprovisionar automaticamente usuários e grupos no zendesk.This tutorial demonstrates the steps to perform in Zendesk and Azure Active Directory (Azure AD) to configure Azure AD to automatically provision and deprovision users and groups to Zendesk.

Observação

Este tutorial descreve um conector que é criado sobre o serviço de provisionamento de usuário do Azure AD.This tutorial describes a connector that's built on top of the Azure AD user provisioning service. Para obter informações sobre o que esse serviço faz, como ele funciona e perguntas frequentes, consulte automatizar o provisionamento e desprovisionamento de usuários para aplicativos SaaS (software como serviço) com Azure Active Directory.For information on what this service does, how it works, and frequently asked questions, see Automate user provisioning and deprovisioning to software-as-a-service (SaaS) applications with Azure Active Directory.

Pré-requisitosPrerequisites

O cenário descrito neste tutorial pressupõe que você tenha:The scenario outlined in this tutorial assumes that you have:

  • Um locatário do Azure AD.An Azure AD tenant.
  • Um locatário do zendesk com o plano profissional ou melhor habilitado.A Zendesk tenant with the Professional plan or better enabled.
  • Uma conta de usuário no zendesk com permissões de administrador.A user account in Zendesk with admin permissions.

Adicionar o zendesk do Azure MarketplaceAdd Zendesk from the Azure Marketplace

Antes de configurar o zendesk para o provisionamento automático de usuário com o Azure AD, adicione o zendesk do Azure Marketplace à sua lista de aplicativos SaaS gerenciados.Before you configure Zendesk for automatic user provisioning with Azure AD, add Zendesk from the Azure Marketplace to your list of managed SaaS applications.

Para adicionar o zendesk do Marketplace, siga estas etapas.To add Zendesk from the Marketplace, follow these steps.

  1. No portal do Azure, no painel de navegação à esquerda, selecione Azure Active Directory.In the Azure portal, in the navigation pane on the left, select Azure Active Directory.

    O ícone de Azure Active Directory

  2. Vá para Aplicativos da empresa, em seguida, selecione Todos os aplicativos.Go to Enterprise applications, and then select All applications.

    A folha Aplicativos empresariais

  3. Para adicionar um novo aplicativo, selecione Novo aplicativo na parte superior da caixa de diálogo.To add a new application, select New application at the top of the dialog box.

    O botão Novo aplicativo

  4. Na caixa de pesquisa, digite zendesk e selecione zendesk no painel de resultados.In the search box, enter Zendesk and select Zendesk from the result panel. Para adicionar o aplicativo, selecione Adicionar.To add the application, select Add.

    Zendesk na lista de resultados

Atribuir usuários ao zendeskAssign users to Zendesk

Azure Active Directory usa um conceito chamado atribuições para determinar quais usuários devem receber acesso aos aplicativos selecionados.Azure Active Directory uses a concept called assignments to determine which users should receive access to selected apps. No contexto do provisionamento automático de usuário, somente os usuários ou grupos que foram atribuídos a um aplicativo no Azure AD são sincronizados.In the context of automatic user provisioning, only the users or groups that were assigned to an application in Azure AD are synchronized.

Antes de configurar e habilitar o provisionamento automático de usuário, decida quais usuários ou grupos no Azure AD precisam de acesso ao zendesk.Before you configure and enable automatic user provisioning, decide which users or groups in Azure AD need access to Zendesk. Para atribuir esses usuários ou grupos ao zendesk, siga as instruções em atribuir um usuário ou grupo a um aplicativo empresarial.To assign these users or groups to Zendesk, follow the instructions in Assign a user or group to an enterprise app.

Dicas importantes para atribuir usuários ao ZendeskImportant tips for assigning users to Zendesk

  • Hoje, as funções do zendesk são preenchidas de forma automática e dinâmica na interface do usuário do portal do Azure.Today, Zendesk roles are automatically and dynamically populated in the Azure portal UI. Antes de atribuir funções do zendesk a usuários, verifique se uma sincronização inicial foi concluída no zendesk para recuperar as funções mais recentes em seu locatário do zendesk.Before you assign Zendesk roles to users, make sure that an initial sync is completed against Zendesk to retrieve the latest roles in your Zendesk tenant.

  • Recomendamos que você atribua um único usuário do Azure AD ao zendesk para testar a configuração inicial de provisionamento automático de usuário.We recommend that you assign a single Azure AD user to Zendesk to test your initial automatic user provisioning configuration. Você pode atribuir usuários ou grupos adicionais posteriormente depois que os testes forem bem-sucedidos.You can assign additional users or groups later after the tests are successful.

  • Quando você atribuir um usuário ao zendesk, selecione qualquer função específica do aplicativo válida, se disponível, na caixa de diálogo atribuição.When you assign a user to Zendesk, select any valid application-specific role, if available, in the assignment dialog box. Usuários com a função Acesso padrão são excluídos do provisionamento.Users with the Default Access role are excluded from provisioning.

Configurar o provisionamento automático de usuário para o zendeskConfigure automatic user provisioning to Zendesk

Esta seção orienta você pelas etapas para configurar o serviço de provisionamento do Azure AD.This section guides you through the steps to configure the Azure AD provisioning service. Use-o para criar, atualizar e desabilitar usuários ou grupos no zendesk com base em atribuições de usuário ou de grupo no Azure AD.Use it to create, update, and disable users or groups in Zendesk based on user or group assignments in Azure AD.

Dica

Você também pode habilitar o logon único baseado em SAML para o zendesk.You also can enable SAML-based single sign-on for Zendesk. Siga as instruções no tutorial de logon único do zendesk.Follow the instructions in the Zendesk single sign-on tutorial. O logon único pode ser configurado independentemente do provisionamento automático de usuário, embora esses dois recursos se complementem.Single sign-on can be configured independently of automatic user provisioning, although these two features complement each other.

Configurar o provisionamento automático de usuário para o zendesk no Azure ADConfigure automatic user provisioning for Zendesk in Azure AD

  1. Entre no Portal do Azure.Sign in to the Azure portal. Selecione aplicativos > empresariaistodos os aplicativos > zendesk.Select Enterprise applications > All applications > Zendesk.

    Folha de aplicativos empresariais

  2. Na lista de aplicativos, selecione Zendesk.In the applications list, select Zendesk.

    O link do zendesk na lista de aplicativos

  3. Selecione a guia Provisionamento.Select the Provisioning tab.

    Provisionamento do Zendesk

  4. Defina o Modo de Provisionamento como Automático.Set the Provisioning Mode to Automatic.

    Modo de provisionamento do zendesk

  5. Na seção credenciais de administrador , insira o nome de usuário do administrador, o token secreto e o domínio da sua conta do zendesk.Under the Admin Credentials section, input the admin username, secret token, and domain of your Zendesk account. Exemplos desses valores são:Examples of these values are:

    • Na caixa nome de usuário administrador , preencha o nome de usuário da conta de administrador em seu locatário do zendesk.In the Admin Username box, fill in the username of the admin account on your Zendesk tenant. Um exemplo é admin@contoso.com.An example is admin@contoso.com.

    • Na caixa token secreto , preencha o token secreto, conforme descrito na etapa 6.In the Secret Token box, fill in the secret token as described in Step 6.

    • Na caixa domínio , preencha o subdomínio de seu locatário do zendesk.In the Domain box, fill in the subdomain of your Zendesk tenant. Por exemplo, para uma conta com uma URL de locatário https://my-tenant.zendesk.comdo, seu subdomínio é meu locatário.For example, for an account with a tenant URL of https://my-tenant.zendesk.com, your subdomain is my-tenant.

  6. O token secreto para sua conta do zendesk está localizado emconfiguraçõesdaAPI > de Administração > .The secret token for your Zendesk account is located in Admin > API > Settings. Verifique se o acesso ao token está definido como habilitado.Make sure that Token Access is set to Enabled.

    Configurações de administrador do zendesk

    Token secreto do zendesk

  7. Depois de preencher as caixas mostradas na etapa 5, selecione testar conexão para garantir que o Azure ad possa se conectar ao zendesk.After you fill in the boxes shown in Step 5, select Test Connection to make sure that Azure AD can connect to Zendesk. Se a conexão falhar, verifique se sua conta do zendesk tem permissões de administrador e tente novamente.If the connection fails, make sure your Zendesk account has admin permissions and try again.

    Conexão de teste do zendesk

  8. Na caixa email de notificação , insira o endereço de email da pessoa ou grupo para receber as notificações de erro de provisionamento.In the Notification Email box, enter the email address of the person or group to receive the provisioning error notifications. Marque a caixa de seleção Enviar uma notificação por email quando ocorrer uma falha .Select the Send an email notification when a failure occurs check box.

    Email de notificação do zendesk

  9. Clique em Salvar.Select Save.

  10. Na seção Mapeamentos, selecione Sincronizar Usuários do Azure Active Directory com o Zendesk.Under the Mappings section, select Synchronize Azure Active Directory Users to Zendesk.

    Sincronização de usuário do zendesk

  11. Examine os atributos de usuário que são sincronizados do Azure AD para o zendesk na seção mapeamentos de atributo .Review the user attributes that are synchronized from Azure AD to Zendesk in the Attribute Mappings section. Os atributos selecionados como propriedades Correspondentes serão usados para corresponder as contas de usuário no Zendesk para operações de atualização.The attributes selected as Matching properties are used to match the user accounts in Zendesk for update operations. Para salvar as alterações, selecione salvar.To save any changes, select Save.

    Atributos de usuário correspondentes ao zendesk

  12. Na seção mapeamentos , selecione sincronizar grupos de Azure Active Directory para o zendesk.Under the Mappings section, select Synchronize Azure Active Directory Groups to Zendesk.

    Sincronização de grupo do zendesk

  13. Examine os atributos de grupo que são sincronizados do Azure AD para o zendesk na seção mapeamentos de atributo .Review the group attributes that are synchronized from Azure AD to Zendesk in the Attribute Mappings section. Os atributos selecionados como propriedades Correspondentes são usados para corresponder os grupos do Zendesk em operações de atualização.The attributes selected as Matching properties are used to match the groups in Zendesk for update operations. Para salvar as alterações, selecione salvar.To save any changes, select Save.

    Atributos do grupo de correspondência do zendesk

  14. Para configurar filtros de escopo, siga as instruções no tutorial filtro de escopo.To configure scoping filters, follow the instructions in the scoping filter tutorial.

  15. Para habilitar o serviço de provisionamento do Azure AD para o zendesk, na seção configurações , altere o status de provisionamento para ativado.To enable the Azure AD provisioning service for Zendesk, in the Settings section, change Provisioning Status to On.

    Status de provisionamento do zendesk

  16. Defina os usuários ou grupos que você deseja provisionar no zendesk.Define the users or groups that you want to provision to Zendesk. Na seção configurações , selecione os valores desejados no escopo.In the Settings section, select the values you want in Scope.

    Escopo do zendesk

  17. Quando estiver pronto para provisionar, selecione salvar.When you're ready to provision, select Save.

    Salvamento do zendesk

Essa operação inicia a sincronização inicial de todos os usuários ou grupos definidos no escopo na seção configurações .This operation starts the initial synchronization of all users or groups defined in Scope in the Settings section. A sincronização inicial demora mais para ser executada do que as sincronizações posteriores.The initial sync takes longer to perform than later syncs. Eles ocorrem aproximadamente a cada 40 minutos, desde que o serviço de provisionamento do Azure AD seja executado.They occur approximately every 40 minutes as long as the Azure AD provisioning service runs.

Você pode usar a seção detalhes de sincronização para monitorar o progresso e seguir os links para o relatório de atividade de provisionamento.You can use the Synchronization Details section to monitor progress and follow links to the provisioning activity report. O relatório descreve todas as ações executadas pelo serviço de provisionamento do Azure AD no zendesk.The report describes all the actions performed by the Azure AD provisioning service on Zendesk.

Para obter informações sobre como ler os logs de provisionamento do Azure AD, confira Relatórios sobre o provisionamento automático de contas de usuário.For information on how to read the Azure AD provisioning logs, see Reporting on automatic user account provisioning.

Limitações do conectorConnector limitations

  • O zendesk dá suporte ao uso de grupos somente para usuários com funções de agente .Zendesk supports the use of groups for users with Agent roles only. Para obter mais informações, consulte a documentação do zendesk.For more information, see the Zendesk documentation.

  • Quando uma função personalizada é atribuída a um usuário ou grupo, o serviço de provisionamento automático de usuário do Azure AD também atribui o agentede função padrão.When a custom role is assigned to a user or group, the Azure AD automatic user provisioning service also assigns the default role Agent. Somente os agentes podem ser atribuídos a uma função personalizada.Only Agents can be assigned a custom role. Para obter mais informações, consulte a documentação da API do zendesk.For more information, see the Zendesk API documentation.

Recursos adicionaisAdditional resources

Próximas etapasNext steps