functions/invoke-passwordgrant.ps1
|
<# .SYNOPSIS Invoke a password authorization flow .DESCRIPTION Invoke an OAuth 2.0 Password Grant flow against the authorization server .PARAMETER AuthProviderUri The URL / URI for the authorization server .PARAMETER Resource The URL / URI for the protected resource you want the token to be valid to .PARAMETER ClientId The Client Id that you want to use for the authentication process .PARAMETER Username Username for the user that you want to authenticate as .PARAMETER Password Password for the user that you want to authenticate as .PARAMETER Scope The scope details that you want the token to valid for .PARAMETER EnableException This parameters disables user-friendly warnings and enables the throwing of exceptions This is less user friendly, but allows catching exceptions in calling scripts .EXAMPLE PS C:\> Invoke-PasswordGrant -AuthProviderUri "https://login.microsoftonline.com/common/oauth2/token" -Resource "https://www.superfantasticservername.com" -ClientId "dea8d7a9-1602-4429-b138-111111111111" -Username "serviceaccount@domain.com" -Password "TopSecretPassword" -Scope "openid" This will invoke an OAuth Password Grant flow against Azure Active Directory for the common endpoint. The token will be valid for the "https://www.superfantasticservername.com" resource. The ClientId is "dea8d7a9-1602-4429-b138-111111111111". The Username is "serviceaccount@domain.com". The Password is "TopSecretPassword". The Scope is "openid". .NOTES Author: Mötz Jensen (@Splaxi) #> function Invoke-PasswordGrant { [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidUsingPlainTextForPassword", "")] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidUsingUserNameAndPassWordParams", "")] [CmdletBinding()] [OutputType()] param ( [Parameter(Mandatory = $true)] [string] $AuthProviderUri, [Parameter(Mandatory = $true)] [Alias('URL')] [Alias('URI')] [string] $Resource, [Parameter(Mandatory = $true)] [string] $ClientId, [Parameter(Mandatory = $true)] [string] $Username, [Parameter(Mandatory = $true)] [string] $Password, [string] $Scope, [switch] $EnableException ) Invoke-Authorization @PSBoundParameters -GrantType "password" } |