Spring til indhold
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Autorisation

Brugerautorisation udføres med roller. Roller kan enten tildeles via tilknytning af claims, et politikscript eller ved at tildele rollen direkte til identiteten.

Ingen roller tildeles automatisk som standard. En lokal administratorkonto oprettes under førstegangsopsætningen og bruges til at konfigurere rolletildelinger.

Tilknytning af rolle til claim

De kan knytte roller til et claim (f.eks. et gruppemedlemskab) ved hjælp af parametrene -ClaimType og -ClaimValue for New-PSURole. Indstillinger er også tilgængelige i dialogboksen for rollegenskaber under Secure > Roles.

Hvis De for eksempel med Windows-godkendelse vil knytte en gruppe til en rolle, kan De konfigurere det, så gruppens SID knyttes til administratorrollen.

New-PSURole -Name Administrator -ClaimType 'http://schemas.microsoft.com/ws/2008/06/identity/claims/groupsid' -ClaimValue 'S-123-123-123'

Tilknytning af roller til claims på denne måde er hurtigere end politikscripts, fordi det ikke kræver, at PowerShell køres, når brugeren logger på.

Vis claimoplysninger

For at hjælpe med at udvikle politikscripts eller tildele roller til claims kan De få vist claimoplysninger ved at klikke på View Claim Information under Secure > Roles.

Eksempel: Azure Active Directory

De kan knytte en Azure Active Directory-gruppe til en rolle ved at slå gruppens Object ID op i Azure. I Ironman Software-domænet har vi for eksempel en gruppe, der hedder Dashboard Administrators. Denne gruppe har object ID'et 61849bf2-e44b-4057-b589-6cd1812d7545.

I PowerShell Universal kan jeg tildele brugere i denne gruppe til gruppen Administrator ved at konfigurere claimtilknytningen. Claim Type bliver groups, og Claim Value bliver 61849bf2-e44b-4057-b589-6cd1812d7545. Når jeg har tilknyttet claimet, bliver brugere i gruppen Dashboard Administrators en del af gruppen PowerShell Universal Administrators. Den resulterende roles.ps1 ser sådan ud.

Alle andre roller er deaktiveret.

New-PSURole -Name Administrator -ClaimType 'groups' -ClaimValue '61849bf2-e44b-4057-b589-6cd1812d7545'
New-PSURole -Name "Operator" -Description "Operators have access to manage and execute scripts, create other entities within PowerShell Universal but cannot manage PowerShell Universal itself." -Policy {} -Disabled
New-PSURole -Name "Reader" -Description "Readers have read-only access to PowerShell Universal. They cannot make changes to any entity within the system." -Policy { } -Disabled 
New-PSURole -Name "Execute" -Description "Execute scripts within PowerShell Universal." -Policy { } -Disabled
New-PSURole -Name "User" -Description "Does not have access to the admin console but can be assigned resources like APIs, scripts, dashboards and pages." -Policy { } -Disabled

Tildeling af politik

Som standard tildeles roller af politikker. Politikker køres, når brugeren logger på. De kan ændre politikscriptene ved at gå til Secure > Roles. Klik på knappen Edit Code for at konfigurere politikscriptet.

Politikscripts modtager et ClaimsPrincipal-objekt som parameter og skal returnere true eller false. Politikker, der udløser fejl, antages at være false. Objektet ClaimsPrincipal indeholder brugerens identitet og de krav, som brugeren har modtaget. Disse kan omfatte gruppetildelinger eller andre funktioner på en brugers konto.

De kan forvente et objekt med denne struktur.

Rolletildeling

For at tildele en rolle til en bruger kan De oprette vedkommendes identitet i Universal og derefter vælge rollen i rullelisten under Secure > Identities.

Som standard modtager identiteter en rolle via claimtilknytning eller politik.

Importér roller

Når Windows-godkendelse er aktiveret, kan De klikke på knappen Import Windows Groups for at vælge grupper, som De vil importere til PowerShell Universal. Når De har valgt disse grupper, oprettes roller med Role to Claim-tilknytning, uden at det skal konfigureres manuelt.

Indbyggede roller

Administrator

Fuld adgang til hele PowerShell Universal-platformen og indstillingerne.

Operator

Operatører har adgang til at tilføje og fjerne ressourcer såsom API'er, Scripts og Dashboards. Operatører kan ikke ændre indstillinger som miljøer, roller eller generelle indstillinger.

Execute

Rollen Execute giver mulighed for at køre scripts og læseadgang til alt andet.

Reader

Rollen Reader giver skrivebeskyttet adgang til PowerShell Universal.

Standardrute pr. rolle

De kan ændre, hvilken side brugeren ser ved logon, ved at angive egenskaben Default Route for rollen. De kan f.eks. ønske, at HR-brugere går til dashboardet Human Resources, mens De ønsker, at IT-brugere går til IT Dashboard.

Brugere med mange grupper

Hvis Deres brugere er medlemmer af mere end ca. 40 grupper, kan De opleve problemer med at logge på. Det skyldes størrelsesbegrænsninger for HTTP-headerne i IIS og Kestrel. Jo flere grupper en bruger er medlem af, jo flere autorisationsclaims har de, og jo større er headeren.

De kan øge headergrænsen for Kestrel ved hjælp af limits-konfigurationen i filen appsettings.json. De skal øge headerstørrelsen. Det er en værdi i byte og er som standard 32kb.

IIS-autorisation

Autorisation i IIS fungerer som med enhver anden metode, men De skal være opmærksom på størrelsesgrænsen for anmodningsheaderen. De kan modtage fejl, når De aktiverer krav, der omfatter mange grupper. Kravene kan overskride størrelsesgrænsen for headeren, og IIS returnerer fejl. Vi har konstateret, at ca. 40 Azure Active Directory-grupper forårsager dette problem på en standardinstallation af IIS.

Den fejl, De vil modtage, vil enten være en 400-fejl om, at anmodningen er for lang.

Bad Request - Request Too Long HTTP Error 400. The size of the request headers is too long.

Hvis De har HTTPS aktiveret, vil De modtage en fejl om en HTTP2-protokolfejl.

De kan øge IIS-anmodningsstørrelsen ved at angive følgende nøgler i registreringsdatabasen. De skal genstarte Deres computer, for at de træder i kraft.

Yderligere oplysninger findes i Microsofts dokumentation.

Som alternativ til at øge anmodningsstørrelsen kan De også reducere antallet af grupper, der sendes. I Azure Active Directory kan De angive, at kun de grupper, der er tildelt programmet, sendes, for at forhindre, at alle grupper sendes.

I Azure skal De gå til App registrations > (Vælg appen) > Token Configuration og angive de grupper, der er tildelt programmet.

Gå nu til Enterprise Application > (Vælg programmet) > Users and groups. Tildel den eller de grupper, De er interesseret i at medtage i claims. (Bemærk: dette kan også bruges som en sikkerhedsgrænse, hvis De sætter “User Assignment Required” til Yes i afsnittet ‘Properties’ i programmet)

App Tokens

App Tokens kan tildeles tjenester, der ikke kan logge på interaktivt. De kan tildele et nyt app-token til Deres konto ved at klikke på knappen Grant App Token under User menu > User Settings > Tokens.

Tokenet vil have en udløbstid på et år og have de gyldige roller for Deres konto. For at kopiere App Token til Deres konto skal De klikke på handlingen Copy. For at tilbagekalde et App Token skal De klikke på handlingen Revoke.

De kan bruge App Tokens sammen med Universal-cmdlets eller ved at bruge webanmodninger direkte ved hjælp af ****** src="https://218893503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAje1UFQFSPx2kH2ueeCf%2Fuploads%2Fgit-blob-d2492c5fb69b57572019e3d793148c0e0c53370c%2Fimage%20(224).png?alt=media" alt="">

App Tokens-side

Miljø

Som standard kører scripts til formulargodkendelse og politiktildeling i PowerShell Universal-processen. Når De konfigurerer et sikkerhedsmiljø, startes en ekstern PowerShell-proces, som konfigureres til at bruge Deres miljøs indstillinger.

For at justere det miljø, der bruges af sikkerhedsprocessen, skal De angive -SecurityEnvironment i settings.ps1.

Eksempel: formulargodkendelse med Active Directory

Følgende eksempel viser udførelse af et simpelt "LDAP BIND" for at validere en brugers legitimationsoplysninger til Active Directory. Hvis en bruger, der forsøger at få adgang til PowerShell Universal, ikke er standardadministratorbrugeren, skal vedkommende godkende sine legitimationsoplysninger over for Active Directory via et simpelt LDAP-bind. Dette kan kombineres med en kontrol af medlemskab af en AD-gruppe i rollepolitikkerne Admin, Operator og Reader for effektivt at bruge godkendelse med Active Directory OG medlemskab af Active Directory-gruppe til at give rollebaseret adgang til PowerShell Universal.

Eksempel: politik baseret på Active Directory-gruppemedlemskab (Windows-godkendelse)

Dette eksempel kræver en godkendelsesmetode, der leverer gruppeoplysninger under godkendelsesprocessen. Metoder som Windows-godkendelse og WS-Federation kan levere disse oplysninger. Forms-godkendelse fungerer ikke med denne type politik.

Dette eksempel gør brug af de claims, der leveres under godkendelse. De kan kontrollere, om brugeren har et groupsid (gruppemedlemskab), ved hjælp af claimtilknytninger. Knyt claimtypen groupid til den værdi, De vil tildele rollen til.

Eksempel: politik baseret på medlemskab af en Active Directory-gruppe

I dette eksempel konfigurerer vi vores script til administratorpolitik, så det bruger LDAP til at hente medlemskabet af en Active Directory-gruppe. Her har vi oprettet en gruppe kaldet "PowerShell Universal Admins", hvor medlemmer af gruppen skal tildeles administratoradgang i PowerShell Universal. Her udfører vi en simpel kontrol af samaccountname for brugeren for at sikre, at vedkommende er medlem af gruppen. I mere robuste miljøer ville en kontrol af SID/DN/ObjectGUID være mere passende.

Eksempel: gruppemedlemskab baseret på Azure Active Directory

Dette eksempel benytter sig af OpenID Connect og Azure Active Directory.

Når De har konfigureret PowerShell Universal og Azure Active Directory, kan De konfigurere rollescripts til at kontrollere, om brugere er medlemmer af grupper, der findes i Azure AD. De kan udnytte claimstilknytninger til at knytte fra Azure AD Group ID til en PowerShell Universal-rolle.

Sørg først for, at claims for gruppemedlemskab er aktiveret i manifestet for Deres programregistrering. Dette vil medtage alt gruppemedlemskab, så det er tilgængeligt i PowerShell Universal.

Når det er konfigureret, kan De opdatere Deres rollescript, så det kontrollerer et gruppemedlemskab. Notér først objekt-id'et for den gruppe, De vil kontrollere i Azure AD.

Dernæst kan De i Deres script roles.ps1 validere, at en bruger har en bestemt rolle, ved hjælp af tilknytning af claims.

Når brugere logger på, valideres deres gruppemedlemskab mod deres claims, og en rolle tildeles.

Se også

Sidst opdateret

Var dette nyttigt?