Konfigurera inloggningsbeteende med hjälp av Home Realm Discovery

• Den senaste förhandsversionen av Azure AD PowerShell-cmdleten.

Vi använder Azure AD PowerShell-cmdletar för att gå igenom några scenarier, bland annat:

Vi använder Microsoft Graph för att gå igenom några scenarier, bland annat:

I följande exempel skapar, uppdaterar, länkar och tar du bort HRD-principer för programtjänstens huvudnamn i Microsoft Entra-ID.

1. Innan du börjar kör du kommandot Anslut för att logga in på Microsoft Entra ID med ditt administratörskonto:

   Connect-AzureAD -Confirm
   

2. Kör följande kommando för att se alla principer i din organisation:

   Get-AzureADPolicy
   

Om inget returneras innebär det att du inte har några principer som skapats i din klientorganisation.

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
}

Om du vill se din nya princip och hämta dess ObjectID kör du följande kommando:

Get-AzureADPolicy

Om du vill tillämpa HRD-principen när du har skapat den kan du tilldela den till flera huvudnamn för programtjänsten.

Leta upp tjänstens huvudnamn som ska tilldelas till principen

Du behöver ObjectID för tjänstens huvudnamn som du vill tilldela principen till. Det finns flera sätt att hitta ObjectID för tjänstens huvudnamn.

Du kan använda administrationscentret för Microsoft Entra eller fråga Microsoft Graph. Du kan också gå till Graph Explorer-verktyget och logga in på ditt Microsoft Entra-konto för att se alla organisationens huvudnamn för tjänsten.

Eftersom du använder PowerShell kan du använda följande cmdlet för att lista tjänstens huvudnamn och deras ID:n.

Get-AzureADServicePrincipal

Tilldela principen till tjänstens huvudnamn

När du har ObjectID för tjänstens huvudnamn för programmet som du vill konfigurera automatisk acceleration för kör du följande kommando. Det här kommandot associerar HRD-principen som du skapade i steg 1 med tjänstens huvudnamn som du placerade i steg 2.

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

Du kan upprepa det här kommandot för varje tjänsthuvudnamn som du vill lägga till principen i.

Om ett program redan har tilldelats en HomeRealmDiscovery-princip kan du inte lägga till en till. I så fall ändrar du definitionen av hrd-principen som har tilldelats till programmet för att lägga till extra parametrar.

Kontrollera vilka tjänsthuvudnamn som din HRD-princip har tilldelats

Om du vill kontrollera vilka program som har konfigurerat HRD-principer använder du cmdleten Get-AzureADPolicyAppliedObject . Skicka ObjectID för principen som du vill kontrollera.

Get-AzureADPolicyAppliedObject -id <ObjectId of the Policy>

Prova programmet för att kontrollera att den nya principen fungerar.

Visa en lista över de program som HRD-principen har konfigurerats för

1. Visa en lista över alla principer som har skapats i din organisation

   Get-AzureADPolicy
   

Observera ObjectID för principen som du vill visa tilldelningar för.

2. Visa en lista över de tjänsthuvudnamn som principen har tilldelats

   Get-AzureADPolicyAppliedObject -id <ObjectId of the Policy>
   

Ta bort en HRD-princip från ett program

1. Hämta ObjectID

   Använd föregående exempel för att hämta ObjectID för principen och det programtjänsthuvudnamn som du vill ta bort det från.

2. Ta bort principtilldelningen från programtjänstens huvudnamn

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

3. Kontrollera borttagningen genom att visa en lista över de tjänsthuvudnamn som principen har tilldelats

   Get-AzureADPolicyAppliedObject -id <ObjectId of the Policy>
   

Konfigurera en princip via Graph Explorer

Från Microsoft Graph Explorer-fönstret:

1. Logga in med en av rollerna som anges i avsnittet krav.

2. Bevilja medgivande till behörigheten Policy.ReadWrite.ApplicationConfiguration .

3. Använd principen för identifiering av hemsfär för att skapa en ny princip.

4. PUBLICERA den nya principen eller PATCH för att uppdatera en befintlig princip.

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

5. Om du vill visa din nya princip kör du följande fråga:

   GET /policies/homeRealmDiscoveryPolicies/{id}
   

6. Så här tilldelar du den nya principen till ett program:

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

   Eller:

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

7. Visa en lista över de tjänsthuvudnamn som principen har tilldelats

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

8. Kör frågan för att ta bort hrd-principen som du skapade:

   DELETE /policies/homeRealmDiscoveryPolicies/{id}
   

9. Ta bort principtilldelningen från tjänstens huvudnamn

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

   Eller

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

10. Kontrollera borttagningen genom att visa en lista över de tjänsthuvudnamn som principen har tilldelats

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