Upravit

Konfigurace zásad životnosti tokenů (Preview)

  • Postupy

V následujících krocích implementujete běžný scénář zásad, který ukládá nová pravidla pro životnost tokenu. Je možné zadat životnost přístupového tokenu, SAML nebo ID vydaného platformou Microsoft Identity Platform. To se dá nastavit pro všechny aplikace ve vaší organizaci nebo pro konkrétní aplikaci nebo objekt zabezpečení. Dají se také nastavit pro více organizací (víceklientských aplikací). Další informace najdete v tématu Konfigurovatelné životnosti tokenů.

Požadavky

Začněte tím, že si stáhnete nejnovější sadu Microsoft Graph PowerShell SDK.

Vytvoření zásady a jejich přiřazení k aplikaci

V následujících krocích vytvoříte zásadu, která vyžaduje, aby se uživatelé ve webové aplikaci ověřili méně často. Přiřaďte zásadu k aplikaci, která nastaví životnost tokenů přístupu/ID na 4 hodiny pro vaši webovou aplikaci.

Install-Module Microsoft.Graph

Connect-MgGraph -Scopes  "Policy.ReadWrite.ApplicationConfiguration","Policy.Read.All","Application.ReadWrite.All"

# Create a token lifetime policy
$params = @{
  Definition = @('{"TokenLifetimePolicy":{"Version":1,"AccessTokenLifetime":"4:00:00"}}') 
    DisplayName = "WebPolicyScenario"
  IsOrganizationDefault = $false
}
$tokenLifetimePolicyId=(New-MgPolicyTokenLifetimePolicy -BodyParameter $params).Id

# Display the policy
Get-MgPolicyTokenLifetimePolicy -TokenLifetimePolicyId $tokenLifetimePolicyId

# Assign the token lifetime policy to an app
$params = @{
  "@odata.id" = "https://graph.microsoft.com/v1.0/policies/tokenLifetimePolicies/$tokenLifetimePolicyId"
}

$applicationObjectId="11111111-1111-1111-1111-111111111111"

New-MgApplicationTokenLifetimePolicyByRef -ApplicationId $applicationObjectId -BodyParameter $params

# List the token lifetime policy on the app
Get-MgApplicationTokenLifetimePolicy -ApplicationId $applicationObjectId

# Remove the policy from the app
Remove-MgApplicationTokenLifetimePolicyByRef -ApplicationId $applicationObjectId -TokenLifetimePolicyId $tokenLifetimePolicyId

# Delete the policy
Remove-MgPolicyTokenLifetimePolicy -TokenLifetimePolicyId $tokenLifetimePolicyId

Vytvoření zásady a jeho přiřazení k instančnímu objektu

V následujících krocích vytvoříte zásadu, která vyžaduje, aby se uživatelé ve webové aplikaci ověřili méně často. Přiřaďte zásadu instančnímu objektu, který nastaví životnost tokenů přístupu/ID na 8 hodin pro vaši webovou aplikaci.

  1. Vytvořte zásadu životnosti tokenu.

    POST https://graph.microsoft.com/v1.0/policies/tokenLifetimePolicies
Content-Type: application/json
{
    "definition": [
        "{\"TokenLifetimePolicy\":{\"Version\":1,\"AccessTokenLifetime\":\"8:00:00\"}}"
    ],
    "displayName": "Contoso token lifetime policy",
    "isOrganizationDefault": false
}

  2. Přiřaďte zásadu instančnímu objektu.

    POST https://graph.microsoft.com/v1.0/servicePrincipals/11111111-1111-1111-1111-111111111111/tokenLifetimePolicies/$ref
Content-Type: application/json
{
  "@odata.id":"https://graph.microsoft.com/v1.0/policies/tokenLifetimePolicies/22222222-2222-2222-2222-222222222222"
}

  3. Vypíše zásady instančního objektu.

    GET https://graph.microsoft.com/v1.0/servicePrincipals/11111111-1111-1111-1111-111111111111/tokenLifetimePolicies

  4. Odeberte zásadu z instančního objektu.

    DELETE https://graph.microsoft.com/v1.0/servicePrincipals/11111111-1111-1111-1111-111111111111/tokenLifetimePolicies/22222222-2222-2222-2222-222222222222/$ref

Zobrazení existujících zásad v tenantovi

Pokud chcete zobrazit všechny zásady vytvořené ve vaší organizaci, spusťte rutinu Get-MgPolicyTokenLifetimePolicy . Všechny výsledky s definovanými hodnotami vlastností, které se liší od výchozích hodnot uvedených výše, jsou v rozsahu vyřazení.

  1. Spuštěním příkazu Get-MgPolicyTokenLifetimePolicy zobrazíte všechny zásady vytvořené ve vaší organizaci.

    Get-MgPolicyTokenLifetimePolicy

  2. Spustit seznam se vztahuje na jakékoli ID zásad, abyste zjistili, které aplikace jsou propojené s konkrétní identifikovanou zásadou.

    GET https://graph.microsoft.com/v1.0/policies/tokenLifetimePolicies/4d2f137b-e8a9-46da-a5c3-cc85b2b840a4/appliesTo

Další krok

Informace o správě relací ověřování