Configurar o comportamento de entrada usando o Home Realm Discovery

• A visualização mais recente do cmdlet do Azure AD PowerShell.

Usamos cmdlets do Azure AD PowerShell para percorrer alguns cenários, incluindo:

Usamos o Microsoft Graph para percorrer alguns cenários, incluindo:

Nos exemplos a seguir, você cria, atualiza, vincula e exclui políticas de DRH em entidades de serviço de aplicativo no Microsoft Entra ID.

1. Antes de começar, execute o comando Connect para iniciar sessão no Microsoft Entra ID com a sua conta de administrador:

   Connect-AzureAD -Confirm
   

2. Execute o seguinte comando para ver todas as políticas na sua organização:

   Get-AzureADPolicy
   

Se nada for devolvido, significa que não tem políticas criadas no seu inquilino.

New-AzureADPolicy 
    -Definition @("{`"HomeRealmDiscoveryPolicy`":{`"AccelerateToFederatedDomain`":true}}") -DisplayName BasicAutoAccelerationPolicy 
    -Type HomeRealmDiscoveryPolicy

POST /policies/homeRealmDiscoveryPolicies

"HomeRealmDiscoveryPolicy": {
    "AccelerateToFederatedDomain": true
}

New-AzureADPolicy 
    -Definition @("{`"HomeRealmDiscoveryPolicy`":{`"AccelerateToFederatedDomain`":true, `"PreferredDomain`":`"federated.example.edu`"}}") 
    -DisplayName MultiDomainAutoAccelerationPolicy 
    -Type HomeRealmDiscoveryPolicy

POST /policies/homeRealmDiscoveryPolicies

"HomeRealmDiscoveryPolicy": {
    "AccelerateToFederatedDomain": true,
    "PreferredDomain": [
      "federated.example.edu"
    ]
}

New-AzureADPolicy 
    -Definition @("{`"HomeRealmDiscoveryPolicy`":{`"AllowCloudPasswordValidation`":true}}") 
    -DisplayName EnableDirectAuthPolicy 
    -Type HomeRealmDiscoveryPolicy

POST /policies/homeRealmDiscoveryPolicies

"EnableDirectAuthPolicy": {
    "AllowCloudPasswordValidation": true
}

Para ver sua nova política e obter seu ObjectID, execute o seguinte comando:

Get-AzureADPolicy

Para aplicar a política de DRH depois de criá-la, você pode atribuí-la a várias entidades de serviço de aplicativo.

Localize a entidade de serviço a ser atribuída à política

Você precisa do ObjectID das entidades de serviço às quais deseja atribuir a política. Há várias maneiras de encontrar o ObjectID de entidades de serviço.

Você pode usar o centro de administração do Microsoft Entra ou consultar o Microsoft Graph. Também pode aceder à Ferramenta Graph Explorer e iniciar sessão na sua conta Microsoft Entra para ver todas as entidades de serviço da sua organização.

Como você está usando o PowerShell, pode usar o cmdlet a seguir para listar as entidades de serviço e suas IDs.

Get-AzureADServicePrincipal

Atribuir a política à entidade de serviço

Depois de ter o ObjectID da entidade de serviço do aplicativo para o qual você deseja configurar a aceleração automática, execute o seguinte comando. Este comando associa a política de DRH que criou no passo 1 à entidade de serviço que localizou no passo 2.

Add-AzureADServicePrincipalPolicy 
    -Id <ObjectID of the Service Principal> 
    -RefObjectId <ObjectId of the Policy>

Você pode repetir esse comando para cada entidade de serviço à qual deseja adicionar a política.

No caso em que um aplicativo já tem uma política HomeRealmDiscovery atribuída, você não pode adicionar uma segunda. Nesse caso, altere a definição da política de DRH atribuída ao aplicativo para adicionar parâmetros extras.

Verifique a quais entidades de serviço sua política de DRH está atribuída

Para verificar quais aplicativos têm a política HRD configurada, use o cmdlet Get-AzureADPolicyAppliedObject . Passe o ObjectID da política que você deseja verificar.

Get-AzureADPolicyAppliedObject -id <ObjectId of the Policy>

Experimente o aplicativo para verificar se a nova política está funcionando.

Listar os aplicativos para os quais a política de DRH está configurada

1. Listar todas as políticas que foram criadas na sua organização

   Get-AzureADPolicy
   

Observe o ObjectID da política para a qual você deseja listar atribuições.

2. Listar as entidades de serviço às quais a política é atribuída

   Get-AzureADPolicyAppliedObject -id <ObjectId of the Policy>
   

Remover uma política de DRH de um aplicativo

1. Obter o ObjectID

   Use o exemplo anterior para obter o ObjectID da política e o da entidade de serviço do aplicativo da qual você deseja removê-lo.

2. Remover a atribuição de política da entidade de serviço de aplicativo

   Remove-AzureADServicePrincipalPolicy -id <ObjectId of the Service Principal>  -PolicyId <ObjectId of the policy>
   

3. Verifique a remoção listando as entidades de serviço às quais a política é atribuída

   Get-AzureADPolicyAppliedObject -id <ObjectId of the Policy>
   

Configurando a política por meio do Graph Explorer

Na janela do explorador do Microsoft Graph:

1. Entre com uma das funções listadas na seção de pré-requisitos.

2. Dê consentimento para a Policy.ReadWrite.ApplicationConfiguration permissão.

3. Use a política de descoberta de território Home para criar uma nova política.

4. POST a nova política ou PATCH para atualizar uma política existente.

   PATCH /policies/homeRealmDiscoveryPolicies/{id}
       {
           "definition": [
           "{\"HomeRealmDiscoveryPolicy\":
           {\"AccelerateToFederatedDomain\":true,
           \"PreferredDomain\":\"federated.example.edu\",
           \"AlternateIdLogin\":{\"Enabled\":true}}}"
       ],
           "displayName": "Home Realm Discovery auto acceleration",
           "isOrganizationDefault": true
       }
   

5. Para exibir sua nova política, execute a seguinte consulta:

   GET /policies/homeRealmDiscoveryPolicies/{id}
   

6. Para atribuir a nova política a um aplicativo:

   POST /servicePrincipals/{id}/homeRealmDiscoveryPolicies/$ref
   

   Ou,

   POST /servicePrincipals(appId='{appId}')/homeRealmDiscoveryPolicies/$ref
   

7. Listar as entidades de serviço às quais a política é atribuída

   GET /policies/homeRealmDiscoveryPolicies/{ObjectId of the policy}/appliesTo
   

8. Para excluir a política de DRH que você criou, execute a consulta:

   DELETE /policies/homeRealmDiscoveryPolicies/{id}
   

9. Remover a atribuição de política da entidade de serviço

   DELETE /servicePrincipals/{id}/homeRealmDiscoveryPolicies/{policyId}/$ref
   

   ou,

   DELETE /servicePrincipals(appId='{appId}')/homeRealmDiscoveryPolicies/{policyId}/$ref
   

10. Verifique a remoção listando as entidades de serviço às quais a política é atribuída

    GET /policies/homeRealmDiscoveryPolicies/{ObjectId of the policy}/appliesTo