SamlSecurityTokenHandler Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Representerar en säkerhetstokenhanterare som skapar säkerhetstoken från SAML 1.1-försäkran.
public ref class SamlSecurityTokenHandler : System::IdentityModel::Tokens::SecurityTokenHandlerpublic class SamlSecurityTokenHandler : System.IdentityModel.Tokens.SecurityTokenHandlertype SamlSecurityTokenHandler = class
inherit SecurityTokenHandlerPublic Class SamlSecurityTokenHandler
Inherits SecurityTokenHandler- Arv
Kommentarer
Klassen SamlSecurityTokenHandler serialiserar och deserialiserar säkerhetstoken som backas upp av SAML 1.1-försäkran till SamlSecurityToken objekt. Säkerhetstokenhanterare ansvarar för att skapa, läsa, skriva och validera token.
Du kan konfigurera en säkerhetstokentjänst (STS) eller ett förlitande partprogram (RP) för att bearbeta SAML 1.1-säkerhetstoken med försäkran genom att lägga till en instans av SamlSecurityTokenHandler klassen i objektet SecurityTokenHandlerCollection som konfigurerats för tjänsten (eller programmet). Detta kan göras antingen programmatiskt eller i konfigurationsfilen. Själva hanteraren konfigureras från den konfiguration som angetts för samlingen via samlingens Configuration egenskap när den läggs till i samlingen. Även om det är möjligt att konfigurera hanteraren individuellt genom att ange dess Configuration egenskap, är detta normalt inte nödvändigt. Men om hanteraren måste konfigureras individuellt bör egenskapen anges när hanteraren har lagts till i samlingen.
I många scenarier SamlSecurityTokenHandler kan klassen användas as-is. Klassen tillhandahåller dock många tilläggspunkter genom de metoder som den exponerar. Genom att härleda från och SamlSecurityTokenHandler åsidosätta specifika metoder kan du ändra funktionerna i tokenbearbetningen som tillhandahålls i standardimplementeringen, eller lägga till bearbetning för tillägg till SAML-försäkran som kan behövas i vissa anpassade scenarier.
Konstruktorer
| Name | Description |
|---|---|
| SamlSecurityTokenHandler() |
Initierar en ny instans av SamlSecurityTokenHandler klassen med standardkrav för säkerhetstoken. |
| SamlSecurityTokenHandler(SamlSecurityTokenRequirement) |
Initierar en ny instans av SamlSecurityTokenHandler klassen med de angivna kraven för säkerhetstoken. |
Fält
| Name | Description |
|---|---|
| Assertion |
urn:oasis:names:tc:SAML:1.0:assertion. |
| BearerConfirmationMethod |
urn:oasis:names:tc:SAML:1.0:cm:bearer. |
| Namespace |
urn:oasis:names:tc:SAML:1.0 |
| UnspecifiedAuthenticationMethod |
urn:oasis:names:tc:SAML:1.0:am:unspecified. |
Egenskaper
| Name | Description |
|---|---|
| CanValidateToken |
Hämtar ett värde som anger om den här hanteraren kan verifiera token av typen SamlSecurityToken. |
| CanWriteToken |
Hämtar ett värde som anger om den här hanteraren kan serialisera token av typen SamlSecurityToken. |
| CertificateValidator |
Hämtar eller anger X.509-certifikatverifieraren som används av den aktuella instansen för att verifiera X.509-certifikat. |
| Configuration |
Hämtar eller anger objektet SecurityTokenHandlerConfiguration som tillhandahåller konfiguration för den aktuella instansen. (Ärvd från SecurityTokenHandler) |
| ContainingCollection |
Hämtar den tokenhanterarsamling som innehåller den aktuella instansen. (Ärvd från SecurityTokenHandler) |
| KeyInfoSerializer |
Hämtar eller anger säkerhetstokens serialiserare som används för att serialisera och deserialisera nyckelidentifierare. |
| SamlSecurityTokenRequirement |
Hämtar eller anger kraven för säkerhetstoken för den här instansen. |
| TokenType |
Hämtar den tokentyp som stöds av den här hanteraren. |
Metoder
| Name | Description |
|---|---|
| AddDelegateToAttributes(ClaimsIdentity, ICollection<SamlAttribute>, SecurityTokenDescriptor) |
Lägger till alla ombud som är associerade med ActAs-ämnet i attributsamlingen. |
| CanReadKeyIdentifierClause(XmlReader) |
Returnerar ett värde som anger om XML-elementet som den angivna XML-läsaren refererar till är en nyckelidentifierarsats som kan deserialiseras av den här instansen. (Ärvd från SecurityTokenHandler) |
| CanReadToken(String) |
Returnerar ett värde som anger om den angivna strängen kan deserialiseras som en token av den typ som bearbetas av den här instansen. (Ärvd från SecurityTokenHandler) |
| CanReadToken(XmlReader) |
Anger om det aktuella XML-elementet kan läsas som en token av den typ som hanteras av den här instansen. |
| CanWriteKeyIdentifierClause(SecurityKeyIdentifierClause) |
Returnerar ett värde som anger om den angivna nyckelidentifierarsatsen kan serialiseras av den här instansen. (Ärvd från SecurityTokenHandler) |
| CollectAttributeValues(ICollection<SamlAttribute>) |
Samlar in attribut med en gemensam anspråkstyp, anspråksvärdetyp och ursprunglig utfärdare i ett enda attribut med flera värden. |
| CreateAdvice(SecurityTokenDescriptor) |
När du åsidosättas i en härledd klass skapar du ett SamlAdvice objekt för försäkran. |
| CreateAssertion(String, SamlConditions, SamlAdvice, IEnumerable<SamlStatement>) |
Skapar ett SamlAssertion objekt med hjälp av den angivna utfärdaren, villkor, råd och instruktioner. Du kan åsidosätta den här metoden för att anpassa de parametrar som används för att skapa försäkran. |
| CreateAttribute(Claim, SecurityTokenDescriptor) |
Skapar ett SamlAttribute objekt från ett anspråk. |
| CreateAttributeStatement(SamlSubject, ClaimsIdentity, SecurityTokenDescriptor) |
Skapar ett SamlAttributeStatement objekt från en tokenbeskrivning. |
| CreateAuthenticationStatement(SamlSubject, AuthenticationInformation, SecurityTokenDescriptor) |
Skapar en SAML 1.1-autentiseringsinstrukation från den angivna autentiseringsinformationen. |
| CreateClaims(SamlSecurityToken) |
Skapar anspråk från en SAML 1.1-token. |
| CreateConditions(Lifetime, String, SecurityTokenDescriptor) |
Skapar villkoren för försäkran. |
| CreateSamlSubject(SecurityTokenDescriptor) |
Skapar ett SAML 1.1-ämne för försäkran. |
| CreateSecurityTokenReference(SecurityToken, Boolean) |
Skapar referensen för säkerhetstoken när token inte är kopplad till meddelandet. |
| CreateStatements(SecurityTokenDescriptor) |
Skapar SAML 1.1-instruktioner som ska ingå i försäkran. |
| CreateToken(SecurityTokenDescriptor) |
Skapar en säkerhetstoken baserat på en tokenbeskrivning. |
| CreateWindowsIdentity(String) |
Skapar ett WindowsIdentity objekt med det angivna upn-namnet (User Principal Name). |
| CreateXmlStringFromAttributes(IEnumerable<SamlAttribute>) |
Skapar en XML-formaterad sträng från en samling SAML 1.1-attribut som representerar aktören. |
| DenormalizeAuthenticationType(String) |
Returnerar den SAML11-autentiseringsmetodidentifierare som matchar det angivna normaliserade värdet för en SAML-autentiseringsmetod. |
| DetectReplayedToken(SecurityToken) |
Utlöser ett undantag om den angivna token redan finns i tokenrepriscacheminnet. annars läggs token till i cacheminnet. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| FindUpn(ClaimsIdentity) |
Söker efter UPN-anspråksvärdet i det angivna ClaimsIdentity objektet i syfte att mappa identiteten till ett WindowsIdentity objekt. |
| GetEncryptingCredentials(SecurityTokenDescriptor) |
Hämtar autentiseringsuppgifterna för tokenkryptering. Åsidosätt den här metoden för att ändra autentiseringsuppgifterna för tokenkryptering. |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetSigningCredentials(SecurityTokenDescriptor) |
Hämtar autentiseringsuppgifterna för signering av försäkran. |
| GetTokenReplayCacheEntryExpirationTime(SamlSecurityToken) |
Returnerar den tid till vilken token ska lagras i tokenrepriscachen. |
| GetTokenTypeIdentifiers() |
Hämtar tokentypidentifierare som stöds av den här hanteraren. |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| LoadCustomConfiguration(XmlNodeList) |
Läser in anpassad konfiguration från XML. |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| NormalizeAuthenticationType(String) |
Returnerar det normaliserade värde som matchar en SAML 1.1-autentiseringsmetodidentifierare. |
| ProcessAttributeStatement(SamlAttributeStatement, ClaimsIdentity, String) |
Skapar anspråk från en SAML 1.1-attributsats och lägger till dem i det angivna ämnet. |
| ProcessAuthenticationStatement(SamlAuthenticationStatement, ClaimsIdentity, String) |
Skapar anspråk från en SAML 1.1-autentiseringsinstrukation och lägger till dem i det angivna ämnet. |
| ProcessAuthorizationDecisionStatement(SamlAuthorizationDecisionStatement, ClaimsIdentity, String) |
Skapar anspråk från en SAML 1.1-auktoriseringsbeslutsinstrukation och lägger till dem i det angivna ämnet. |
| ProcessSamlSubject(SamlSubject, ClaimsIdentity, String) |
Skapar anspråk från SAML 1.1-ämnet och lägger till dem i det angivna ämnet. |
| ProcessStatement(IList<SamlStatement>, ClaimsIdentity, String) |
Skapar anspråk från en samling SAML 1.1-instruktioner och lägger till dem i det angivna ämnet. |
| ReadAction(XmlReader) |
Läser elementet <saml:Action> . |
| ReadAdvice(XmlReader) |
Läser elementet <saml:Advice> . |
| ReadAssertion(XmlReader) |
Läser elementet <saml:Assertion> . |
| ReadAttribute(XmlReader) |
Läser elementet <saml:Attribute> . |
| ReadAttributeStatement(XmlReader) |
Läser elementet <saml:AttributeStatement> eller ett <saml:Statement-element> som anger en xsi:type av saml:AttributeStatementType. |
| ReadAttributeValue(XmlReader, SamlAttribute) |
Läser ett attributvärde. |
| ReadAudienceRestrictionCondition(XmlReader) |
Läser elementet <saml:AudienceRestrictionCondition> från den angivna XML-läsaren. |
| ReadAuthenticationStatement(XmlReader) |
Läser elementet <saml:AuthnStatement> eller ett <saml:Statement-element> som anger en xsi:type av saml:AuthnStatementType. |
| ReadAuthorityBinding(XmlReader) |
Läs elementet <saml:AuthorityBinding> . |
| ReadAuthorizationDecisionStatement(XmlReader) |
Läser elementet <saml:AuthzDecisionStatement> eller ett <saml:Statement-element> som anger en xsi:typ av saml:AuthzDecisionStatementType. |
| ReadCondition(XmlReader) |
Läser en saml:AudienceRestrictionCondition eller en saml:DoNotCacheCondition från den angivna läsaren. |
| ReadConditions(XmlReader) |
Läser elementet <saml:Conditions> . |
| ReadDoNotCacheCondition(XmlReader) |
Läser ett saml:DoNotCacheCondition-element från den angivna XML-läsaren. |
| ReadEvidence(XmlReader) |
Läser elementet <saml:Evidence> . |
| ReadKeyIdentifierClause(XmlReader) |
När den åsidosätts i en härledd klass deserialiserar xml-koden som refereras av den angivna XML-läsaren till en nyckelidentifierarsats som refererar till en token som bearbetas av den härledda klassen. (Ärvd från SecurityTokenHandler) |
| ReadSigningKeyInfo(XmlReader, SamlAssertion) |
Deserialiserar SAML-signeringsnyckelinfo. |
| ReadStatement(XmlReader) |
Läser elementet <saml:Statement> . |
| ReadSubject(XmlReader) |
Läser elementet <saml:Subject> . |
| ReadSubjectKeyInfo(XmlReader) |
Deserialiserar SAML Subject <ds:KeyInfo-elementet> . |
| ReadToken(String) |
När den åsidosättas i en härledd klass deserialiserar den angivna strängen till en token av den typ som bearbetas av den härledda klassen. (Ärvd från SecurityTokenHandler) |
| ReadToken(XmlReader, SecurityTokenResolver) |
När den åsidosättas i en härledd klass, deserialiserar XML som refereras av den angivna XML-läsaren till en token av den typ som bearbetas av den härledda klassen med hjälp av den angivna tokenlösaren. (Ärvd från SecurityTokenHandler) |
| ReadToken(XmlReader) |
Läser en SAML 1.1-token från den angivna strömmen. |
| ResolveIssuerToken(SamlAssertion, SecurityTokenResolver) |
Löser signeringsnyckelidentifieraren till en SecurityToken. |
| ResolveSubjectKeyIdentifier(SecurityKeyIdentifier) |
Löser angivet SecurityKeyIdentifier i ett saml:Subject-element. |
| SetDelegateFromAttribute(SamlAttribute, ClaimsIdentity, String) |
Den här metoden anropas när en särskild typ av SamlAttribute identifieras. Den SamlAttribute som skickas omsluter en SamlAttribute som innehåller en samling attributvärden (i AttributeValues egenskapen), som var och en mappas till ett anspråk. Alla anspråk returneras i ett ClaimsIdentity med den angivna utfärdaren. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| TraceTokenValidationFailure(SecurityToken, String) |
Spårar felhändelsen under valideringen av säkerhetstoken när spårning är aktiverat. (Ärvd från SecurityTokenHandler) |
| TraceTokenValidationSuccess(SecurityToken) |
Spårar den lyckade valideringen av säkerhetstokenhändelsen när spårning är aktiverad. (Ärvd från SecurityTokenHandler) |
| TryResolveIssuerToken(SamlAssertion, SecurityTokenResolver, SecurityToken) |
Löser signeringsnyckelidentifieraren till en SecurityToken. |
| ValidateConditions(SamlConditions, Boolean) |
Verifierar det angivna SamlConditions objektet. |
| ValidateToken(SecurityToken) |
Validerar tokendata och returnerar dess anspråk. |
| WriteAction(XmlWriter, SamlAction) |
Skriver elementet <saml:Action> . |
| WriteAdvice(XmlWriter, SamlAdvice) |
Skriver elementet <saml:Advice> . |
| WriteAssertion(XmlWriter, SamlAssertion) |
Serialiserar den angivna SAML-försäkran till den angivna XML-skrivaren. |
| WriteAttribute(XmlWriter, SamlAttribute) |
Skriver elementet <saml:Attribute> . |
| WriteAttributeStatement(XmlWriter, SamlAttributeStatement) |
Skriver elementet <saml:AttributeStatement> . |
| WriteAttributeValue(XmlWriter, String, SamlAttribute) |
Skriver värdet saml:Attribute. |
| WriteAudienceRestrictionCondition(XmlWriter, SamlAudienceRestrictionCondition) |
Skriver elementet <saml:AudienceRestriction> . |
| WriteAuthenticationStatement(XmlWriter, SamlAuthenticationStatement) |
Skriver elementet <saml:AuthnStatement> . |
| WriteAuthorityBinding(XmlWriter, SamlAuthorityBinding) |
Skriver elementet <saml:AuthorityBinding> . |
| WriteAuthorizationDecisionStatement(XmlWriter, SamlAuthorizationDecisionStatement) |
Skriver elementet <saml:AuthzDecisionStatement> . |
| WriteCondition(XmlWriter, SamlCondition) |
Serialiserar det angivna SamlCondition objektet. |
| WriteConditions(XmlWriter, SamlConditions) |
Skriver elementet <saml:Conditions> . |
| WriteDoNotCacheCondition(XmlWriter, SamlDoNotCacheCondition) |
Skriver elementet <saml:DoNotCacheCondition> . |
| WriteEvidence(XmlWriter, SamlEvidence) |
Skriver elementet <saml:Evidence> . |
| WriteKeyIdentifierClause(XmlWriter, SecurityKeyIdentifierClause) |
När den åsidosättas i en härledd klass serialiserar den angivna nyckelidentifierarsatsen till XML. Nyckelidentifierarsatsen måste vara av den typ som stöds av den härledda klassen. (Ärvd från SecurityTokenHandler) |
| WriteSigningKeyInfo(XmlWriter, SecurityKeyIdentifier) |
Skriver elementet Signing <ds:KeyInfo> med den angivna XML-skrivaren. |
| WriteStatement(XmlWriter, SamlStatement) |
Skriver en SamlStatement. |
| WriteSubject(XmlWriter, SamlSubject) |
Skriver elementet <saml:Subject> . |
| WriteSubjectKeyInfo(XmlWriter, SecurityKeyIdentifier) |
Serialiserar elementet Subject <ds:KeyInfo> med den angivna XML-skrivaren. |
| WriteToken(SecurityToken) |
När den åsidosättas i en härledd klass serialiserar den angivna säkerhetstoken till en sträng. Token måste vara av den typ som bearbetas av den härledda klassen. (Ärvd från SecurityTokenHandler) |
| WriteToken(XmlWriter, SecurityToken) |
Skriver en Saml-token till den angivna XML-skrivaren. |