diagnosticsModule/Public/Test-AdfsServerToken.ps1
|
<#
.SYNOPSIS Performs a synthetic transaction to get a token against an AD FS farm .DESCRIPTION If a credential is provided, then the 2005/usernamemixed Endpoint will be used to get the token. Otherwise, the 2005/windowstransport endpoint will be used with the windows identity of the logged on user. The token is returned in XML format. By default this cmdlet will perform three transactions using Tls 1.0, Tls 1.1, and Tls 1.2. .PARAMETER FederationServer Federation Server (Farm) host name .PARAMETER AppliesTo Identifier of the target relying party .PARAMETER Credential Optional Username Credential used to retrieve the token .PARAMETER TestTls10 Optional switch to specify performing a synthetic transaction using Tls 1.0 .PARAMETER TestTls11 Optional switch to specify performing a synthetic transaction using Tls 1.1 .PARAMETER TestTls12 Optional switch to specify performing a synthetic transaction using Tls 1.2 .EXAMPLE Test-AdfsServerToken -FederationServer sts.contoso.com -AppliesTo urn:payrollapp Retrieves a token for the relying party with identifier urn:payrollapp against the farm 'sts.contoso.com' with logged on user windows credentials .EXAMPLE Test-AdfsServerToken -FederationServer sts.contoso.com -AppliesTo urn:payrollapp -Credential (Get-Credential) Retrieves a token for the relying party with identifier urn:payrollapp against the farm 'sts.contoso.com' using a UserName/Password credential .EXAMPLE $tokenString = Test-AdfsServerToken -FederationServer sts.contoso.com -AppliesTo urn:payrollapp $tokenXml = [Xml]$tokenString $tokenXml.Envelope.Body.RequestSecurityTokenResponse.RequestedSecurityToken.Assertion.AttributeStatement.Attribute | ft Retrieves a token, and see the claims in the attribute statement in a table format .EXAMPLE Test-AdfsServerToken -FederationServer sts.contoso.com -AppliesTo urn:payrollapp -TestTls10 -TestTls11 Perform two synthetic transactions using Tls 1.0 and Tls 1.1 for the relying party with identifier urn:payrollapp against the farm 'sts.contoso.com' with logged on user windows credentials. .NOTES If credential parameter is provided, then the 2005/usernamemixed Endpoint needs to be enabled Otherwise, the 2005/windowstransport endpoint needs to be enabled #> Function Test-AdfsServerToken { param ( [ValidateNotNullOrEmpty()] [string] $FederationServer, [ValidateNotNullOrEmpty()] [string] $AppliesTo, [Parameter(Mandatory = $false)] $Credential, [Switch] $TestTls10, [Switch] $TestTls11, [Switch] $TestTls12 ) $rst = $null $endpoint = $null if ($credential -ne $null) { $endpoint = "https://" + $federationServer + "/adfs/services/trust/2005/usernamemixed" $username = $credential.UserName $password = $credential.GetNetworkCredential().Password $rst = [String]::Format( '<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"><s:Header><a:Action s:mustUnderstand="1">http://schemas.xmlsoap.org/ws/2005/02/trust/RST/Issue</a:Action><a:ReplyTo><a:Address>http://www.w3.org/2005/08/addressing/anonymous</a:Address></a:ReplyTo><a:To s:mustUnderstand="1">{0}</a:To><o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><o:UsernameToken u:Id="uuid-52bba51d-e0c7-4bb1-8c99-6f97220eceba-5"><o:Username>{1}</o:Username><o:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">{2}</o:Password></o:UsernameToken></o:Security></s:Header><s:Body><t:RequestSecurityToken xmlns:t="http://schemas.xmlsoap.org/ws/2005/02/trust"><wsp:AppliesTo xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"><a:EndpointReference><a:Address>{3}</a:Address></a:EndpointReference></wsp:AppliesTo><t:KeySize>0</t:KeySize><t:KeyType>http://schemas.xmlsoap.org/ws/2005/05/identity/NoProofKey</t:KeyType><t:RequestType>http://schemas.xmlsoap.org/ws/2005/02/trust/Issue</t:RequestType><t:TokenType>http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV2.0</t:TokenType></t:RequestSecurityToken></s:Body></s:Envelope>', ` $endpoint, $username, $password, $appliesTo) } else { $endpoint = "https://" + $federationServer + "/adfs/services/trust/2005/windowstransport" $rst = [String]::Format( '<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"><s:Header><a:Action s:mustUnderstand="1">http://schemas.xmlsoap.org/ws/2005/02/trust/RST/Issue</a:Action><a:ReplyTo><a:Address>http://www.w3.org/2005/08/addressing/anonymous</a:Address></a:ReplyTo><a:To s:mustUnderstand="1">{0}</a:To></s:Header><s:Body><t:RequestSecurityToken xmlns:t="http://schemas.xmlsoap.org/ws/2005/02/trust"><wsp:AppliesTo xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"><a:EndpointReference><a:Address>{1}</a:Address></a:EndpointReference></wsp:AppliesTo><t:KeySize>0</t:KeySize><t:KeyType>http://schemas.xmlsoap.org/ws/2005/05/identity/NoProofKey</t:KeyType><t:RequestType>http://schemas.xmlsoap.org/ws/2005/02/trust/Issue</t:RequestType><t:TokenType>http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV2.0</t:TokenType></t:RequestSecurityToken></s:Body></s:Envelope>', ` $endpoint, $appliesTo) } $oldProtocol = [Net.ServicePointManager]::SecurityProtocol $protocolsToTest = @(); if (!($TestTls10) -and !($TestTls11) -and !($TestTls12)) { $protocolsToTest = @($Tls10, $Tls11, $Tls12) } if ($TestTls10) { $protocolsToTest += $Tls10 } if ($TestTls11) { $protocolsToTest += $Tls11 } if ($TestTls12) { $protocolsToTest += $Tls12 } $protocolsToTest | ForEach-Object { try { [Net.ServicePointManager]::SecurityProtocol = $_ $webresp = Invoke-WebRequest $endpoint -Method Post -Body $rst -ContentType "application/soap+xml" -UseDefaultCredentials -UseBasicParsing Write-Host "Successfully performed a synthetic transaction to get a token using TLS version: $_" } catch [Net.WebException] { Out-Warning "Unable to perform a synthetic transaction to get a token using TLS version: $_" } } [Net.ServicePointManager]::SecurityProtocol = $oldProtocol $tokenXml = [xml]$webresp.Content return $tokenXml.OuterXml } |