Provisionamento de entrada controlado por API com o Explorador do Graph

Este tutorial descreve como você pode testar rapidamente o provisionamento de entrada controlado por API com o Microsoft Graph Explorer.

Prerequisite

• Você configurou o aplicativo de provisionamento de entrada controlado por API.

Carregar dados do usuário na API de provisionamento de entrada

1. Abra uma nova guia ou janela do navegador.

2. Inicie a URL https://aka.ms/ge para acessar o Microsoft Graph Explorer.

3. Selecione o ícone de perfil do usuário para entrar.

   

4. Conclua o processo de logon com uma conta de usuário que tenha acesso à função administrador do usuário .

5. Após o logon bem-sucedido, as informações do locatário mostram o nome do locatário.

   

   Agora você está pronto para invocar a API.

6. No painel de solicitação de API, defina o tipo de solicitação HTTP como POST.

7. Copie e cole o ponto de extremidade da API de provisionamento recuperado da página de visão geral do aplicativo de provisionamento.

8. No painel Cabeçalhos de solicitação, adicione um novo par valores de chave de Content-Type = application/scim+json.

9. No painel Corpo da solicitação, copie e cole a solicitação em massa com o esquema de usuário do SCIM Enterprise

10. Selecione no botão Executar consulta para enviar a solicitação para o ponto de extremidade da API de provisionamento.

11. Se a solicitação for enviada com êxito, você receberá uma resposta Accepted 202 do ponto de extremidade da API.

12. Abra o painel Cabeçalhos de resposta e copie o valor da URL do atributo 'location'. Isso aponta para o ponto de extremidade da API de logs de provisionamento que você pode consultar para verificar o status de provisionamento dos usuários presentes na solicitação em massa.

Verifique o processamento do conteúdo da solicitação em massa

Você pode verificar o processamento no Centro de administração do Microsoft Entra ou usando o Explorador do Graph.

Verificar o processamento pelo Centro de administração do Microsoft Entra

1. Faça logon no Centro de administração do Microsoft Entra com pelo menos as credenciais de logon do Administrador de Aplicativos .

2. Navegue para Entra ID>Aplicativos corporativos.

3. Em todos os aplicativos, use a caixa de texto filtro de pesquisa para localizar e abrir seu aplicativo de provisionamento controlado por API.

4. Abra a folha Provisionamento. A página de aterrissagem mostra o status da última execução.

5. Clique em Exibir os logs de provisionamento para abrir a folha de logs de provisionamento. Como alternativa, você pode selecionar a opção de menu Monitor>registros de provisionamento.

   

6. Selecione qualquer registro nos logs de provisionamento para exibir detalhes adicionais de processamento.

7. A tela de detalhes do log de provisionamento exibe todas as etapas executadas para um usuário específico.

   • Na etapa Importar da API , consulte os detalhes dos dados do usuário extraídos da solicitação em massa.
   • A etapa Corresponder usuário mostra os detalhes de qualquer correspondência de usuário com base no identificador de correspondência. Se ocorrer uma correspondência de usuário, o serviço de provisionamento executará uma operação de atualização. Se não houver correspondência de usuário, o serviço de provisionamento executará uma operação de criação.
   • A etapa Determinar se o usuário está no escopo mostra detalhes da avaliação do filtro de escopo. Por padrão, todos os usuários são processados. Se você definir um filtro de escopo (exemplo, processar somente usuários pertencentes ao departamento de Vendas), os detalhes de avaliação do filtro de escopo serão exibidos nesta etapa.
   • A etapa Provisionar Usuário chama a etapa final de processamento e as alterações aplicadas à conta de usuário.
   • Use a guia Propriedades modificadas para exibir atualizações de atributo.

Verificar o processamento usando a API de logs de provisionamento no Explorador do Graph

Você pode inspecionar o processamento usando a URL da API de logs de provisionamento retornada como parte do cabeçalho de resposta do local na chamada à API de provisionamento.

1. Na Explorador do Graph, a caixa de texto URL de Solicitação copia e cola a URL de local retornada pelo ponto de extremidade da API de provisionamento ou você pode construí-la usando o formato: https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' em que você pode recuperar o jobId da página de visão geral do aplicativo de provisionamento.
2. Use o método GET e selecione Executar consulta para recuperar os logs de provisionamento. Por padrão, a resposta retornada contém todos os registros de log.
3. Você pode definir mais filtros para recuperar dados somente após um determinado período de tempo ou com um valor de status específico. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId> and statusInfo/status eq 'failure' and activityDateTime ge 2022-10-10T09:47:34Z Você também pode verificar o status do usuário pelo valor externalId usado no seu sistema de origem que é usado como a âncora de origem/propriedade de junção. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' and sourceIdentity/id eq '701984'

Appendix

Solicitação em massa com o esquema de usuário do SCIM Enterprise

A solicitação em massa a seguir usa o esquema de usuário principal padrão do SCIM e do usuário corporativo.

Request body

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
    "Operations": [
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
            "externalId": "701984",
            "userName": "bjensen@example.com",
            "name": {
                "formatted": "Ms. Barbara J Jensen, III",
                "familyName": "Jensen",
                "givenName": "Barbara",
                "middleName": "Jane",
                "honorificPrefix": "Ms.",
                "honorificSuffix": "III"
            },
            "displayName": "Babs Jensen",
            "nickName": "Babs",
            "emails": [
            {
              "value": "bjensen@example.com",
              "type": "work",
              "primary": true
            }
            ],
            "addresses": [
            {
              "type": "work",
              "streetAddress": "100 Universal City Plaza",
              "locality": "Hollywood",
              "region": "CA",
              "postalCode": "91608",
              "country": "USA",
              "formatted": "100 Universal City Plaza\nHollywood, CA 91608 USA",
              "primary": true
            }
            ],
            "phoneNumbers": [
            {
              "value": "555-555-5555",
              "type": "work"
            }
            ],
            "userType": "Employee",
            "title": "Tour Guide",
            "preferredLanguage": "en-US",
            "locale": "en-US",
            "timezone": "America/Los_Angeles",
            "active":true,
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                 "employeeNumber": "701984",
                 "costCenter": "4130",
                 "organization": "Universal Studios",
                 "division": "Theme Park",
                 "department": "Tour Operations",
                 "manager": {
                     "value": "89607",
                     "displayName": "John Smith"
                 }
            }
        }
    },
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
            "externalId": "701985",
            "userName": "Kjensen@example.com",
            "name": {
                "formatted": "Ms. Kathy J Jensen, III",
                "familyName": "Jensen",
                "givenName": "Kathy",
                "middleName": "Jane",
                "honorificPrefix": "Ms.",
                "honorificSuffix": "III"
            },
            "displayName": "Kathy Jensen",
            "nickName": "Kathy",
            "emails": [
            {
              "value": "kjensen@example.com",
              "type": "work",
              "primary": true
            }
            ],
            "addresses": [
            {
              "type": "work",
              "streetAddress": "100 Oracle City Plaza",
              "locality": "Hollywood",
              "region": "CA",
              "postalCode": "91618",
              "country": "USA",
              "formatted": "100 Oracle City Plaza\nHollywood, CA 91618 USA",
              "primary": true
            }
            ],
            "phoneNumbers": [
            {
              "value": "555-555-5545",
              "type": "work"
            }
            ],
            "userType": "Employee",
            "title": "Tour Lead",
            "preferredLanguage": "en-US",
            "locale": "en-US",
            "timezone": "America/Los_Angeles",
            "active":true,
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                 "employeeNumber": "701985",
                 "costCenter": "4130",
                 "organization": "Universal Studios",
                 "division": "Theme Park",
                 "department": "Tour Operations",
                 "manager": {
                     "value": "701984",
                     "displayName": "Barbara Jensen"
                 }
            }
        }
    }
],
    "failOnErrors": null
}

Next steps

• Solucionar problemas com a API de provisionamento de entrada
• Perguntas frequentes sobre o provisionamento de entrada controlado por API
• Início rápido usando o PowerShell
• Início rápido usando os Aplicativos Lógicos do Azure