1 <?xml version="1.0" encoding="UTF-8"?>
3 xmlns:xs="http://www.w3.org/2001/XMLSchema"
4 elementFormDefault="qualified"
9 Document identifier: saml-schema-authn-context-types-2.0
10 Location: http://docs.oasis-open.org/security/saml/v2.0/
13 New core authentication context schema types for SAML V2.0.
17 <xs:element name="AuthenticationContextDeclaration" type="AuthnContextDeclarationBaseType">
20 A particular assertion on an identity
21 provider's part with respect to the authentication
22 context associated with an authentication assertion.
27 <xs:element name="Identification" type="IdentificationType">
30 Refers to those characteristics that describe the
31 processes and mechanisms
32 the Authentication Authority uses to initially create
33 an association between a Principal
34 and the identity (or name) by which the Principal will
40 <xs:element name="PhysicalVerification">
43 This element indicates that identification has been
44 performed in a physical
45 face-to-face meeting with the principal and not in an
50 <xs:attribute name="credentialLevel">
52 <xs:restriction base="xs:NMTOKEN">
53 <xs:enumeration value="primary"/>
54 <xs:enumeration value="secondary"/>
61 <xs:element name="WrittenConsent" type="ExtensionOnlyType"/>
63 <xs:element name="TechnicalProtection" type="TechnicalProtectionBaseType">
66 Refers to those characterstics that describe how the
67 'secret' (the knowledge or possession
68 of which allows the Principal to authenticate to the
69 Authentication Authority) is kept secure
74 <xs:element name="SecretKeyProtection" type="SecretKeyProtectionType">
77 This element indicates the types and strengths of
79 of a UA used to protect a shared secret key from
80 unauthorized access and/or use.
85 <xs:element name="PrivateKeyProtection" type="PrivateKeyProtectionType">
88 This element indicates the types and strengths of
90 of a UA used to protect a private key from
91 unauthorized access and/or use.
96 <xs:element name="KeyActivation" type="KeyActivationType">
98 <xs:documentation>The actions that must be performed
99 before the private key can be used. </xs:documentation>
103 <xs:element name="KeySharing" type="KeySharingType">
105 <xs:documentation>Whether or not the private key is shared
106 with the certificate authority.</xs:documentation>
110 <xs:element name="KeyStorage" type="KeyStorageType">
113 In which medium is the key stored.
114 memory - the key is stored in memory.
115 smartcard - the key is stored in a smartcard.
116 token - the key is stored in a hardware token.
117 MobileDevice - the key is stored in a mobile device.
118 MobileAuthCard - the key is stored in a mobile
124 <xs:element name="SubscriberLineNumber" type="ExtensionOnlyType"/>
125 <xs:element name="UserSuffix" type="ExtensionOnlyType"/>
127 <xs:element name="Password" type="PasswordType">
130 This element indicates that a password (or passphrase)
132 authenticate the Principal to a remote system.
137 <xs:element name="ActivationPin" type="ActivationPinType">
140 This element indicates that a Pin (Personal
141 Identification Number) has been used to authenticate the Principal to
142 some local system in order to activate a key.
147 <xs:element name="Token" type="TokenType">
150 This element indicates that a hardware or software
152 as a method of identifying the Principal.
157 <xs:element name="TimeSyncToken" type="TimeSyncTokenType">
160 This element indicates that a time synchronization
161 token is used to identify the Principal. hardware -
162 the time synchonization
163 token has been implemented in hardware. software - the
165 token has been implemented in software. SeedLength -
166 the length, in bits, of the
167 random seed used in the time synchronization token.
172 <xs:element name="Smartcard" type="ExtensionOnlyType">
175 This element indicates that a smartcard is used to
176 identity the Principal.
181 <xs:element name="Length" type="LengthType">
184 This element indicates the minimum and/or maximum
185 ASCII length of the password which is enforced (by the UA or the
186 IdP). In other words, this is the minimum and/or maximum number of
187 ASCII characters required to represent a valid password.
188 min - the minimum number of ASCII characters required
189 in a valid password, as enforced by the UA or the IdP.
190 max - the maximum number of ASCII characters required
191 in a valid password, as enforced by the UA or the IdP.
196 <xs:element name="ActivationLimit" type="ActivationLimitType">
199 This element indicates the length of time for which an
200 PIN-based authentication is valid.
205 <xs:element name="Generation">
208 Indicates whether the password was chosen by the
209 Principal or auto-supplied by the Authentication Authority.
210 principalchosen - the Principal is allowed to choose
211 the value of the password. This is true even if
212 the initial password is chosen at random by the UA or
213 the IdP and the Principal is then free to change
215 automatic - the password is chosen by the UA or the
216 IdP to be cryptographically strong in some sense,
217 or to satisfy certain password rules, and that the
218 Principal is not free to change it or to choose a new password.
223 <xs:attribute name="mechanism" use="required">
225 <xs:restriction base="xs:NMTOKEN">
226 <xs:enumeration value="principalchosen"/>
227 <xs:enumeration value="automatic"/>
234 <xs:element name="AuthnMethod" type="AuthnMethodBaseType">
237 Refers to those characteristics that define the
238 mechanisms by which the Principal authenticates to the Authentication
244 <xs:element name="PrincipalAuthenticationMechanism" type="PrincipalAuthenticationMechanismType">
247 The method that a Principal employs to perform
248 authentication to local system components.
253 <xs:element name="Authenticator" type="AuthenticatorBaseType">
256 The method applied to validate a principal's
257 authentication across a network
262 <xs:element name="ComplexAuthenticator" type="ComplexAuthenticatorType">
265 Supports Authenticators with nested combinations of
266 additional complexity.
271 <xs:element name="PreviousSession" type="ExtensionOnlyType">
274 Indicates that the Principal has been strongly
275 authenticated in a previous session during which the IdP has set a
276 cookie in the UA. During the present session the Principal has only
277 been authenticated by the UA returning the cookie to the IdP.
282 <xs:element name="ResumeSession" type="ExtensionOnlyType">
285 Rather like PreviousSession but using stronger
286 security. A secret that was established in a previous session with
287 the Authentication Authority has been cached by the local system and
288 is now re-used (e.g. a Master Secret is used to derive new session
289 keys in TLS, SSL, WTLS).
294 <xs:element name="ZeroKnowledge" type="ExtensionOnlyType">
297 This element indicates that the Principal has been
298 authenticated by a zero knowledge technique as specified in ISO/IEC
304 <xs:element name="SharedSecretChallengeResponse" type="SharedSecretChallengeResponseType"/>
306 <xs:complexType name="SharedSecretChallengeResponseType">
309 This element indicates that the Principal has been
310 authenticated by a challenge-response protocol utilizing shared secret
311 keys and symmetric cryptography.
315 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
317 <xs:attribute name="method" type="xs:anyURI" use="optional"/>
320 <xs:element name="DigSig" type="PublicKeyType">
323 This element indicates that the Principal has been
324 authenticated by a mechanism which involves the Principal computing a
325 digital signature over at least challenge data provided by the IdP.
330 <xs:element name="AsymmetricDecryption" type="PublicKeyType">
333 The local system has a private key but it is used
334 in decryption mode, rather than signature mode. For example, the
335 Authentication Authority generates a secret and encrypts it using the
336 local system's public key: the local system then proves it has
337 decrypted the secret.
342 <xs:element name="AsymmetricKeyAgreement" type="PublicKeyType">
345 The local system has a private key and uses it for
346 shared secret key agreement with the Authentication Authority (e.g.
352 <xs:complexType name="PublicKeyType">
354 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
356 <xs:attribute name="keyValidation" use="optional"/>
359 <xs:element name="IPAddress" type="ExtensionOnlyType">
362 This element indicates that the Principal has been
363 authenticated through connection from a particular IP address.
368 <xs:element name="SharedSecretDynamicPlaintext" type="ExtensionOnlyType">
371 The local system and Authentication Authority
372 share a secret key. The local system uses this to encrypt a
373 randomised string to pass to the Authentication Authority.
378 <xs:element name="AuthenticatorTransportProtocol" type="AuthenticatorTransportProtocolType">
381 The protocol across which Authenticator information is
382 transferred to an Authentication Authority verifier.
387 <xs:element name="HTTP" type="ExtensionOnlyType">
390 This element indicates that the Authenticator has been
391 transmitted using bare HTTP utilizing no additional security
397 <xs:element name="IPSec" type="ExtensionOnlyType">
400 This element indicates that the Authenticator has been
401 transmitted using a transport mechanism protected by an IPSEC session.
406 <xs:element name="WTLS" type="ExtensionOnlyType">
409 This element indicates that the Authenticator has been
410 transmitted using a transport mechanism protected by a WTLS session.
415 <xs:element name="MobileNetworkNoEncryption" type="ExtensionOnlyType">
418 This element indicates that the Authenticator has been
419 transmitted solely across a mobile network using no additional
425 <xs:element name="MobileNetworkRadioEncryption" type="ExtensionOnlyType"/>
426 <xs:element name="MobileNetworkEndToEndEncryption" type="ExtensionOnlyType"/>
428 <xs:element name="SSL" type="ExtensionOnlyType">
431 This element indicates that the Authenticator has been
432 transmitted using a transport mechnanism protected by an SSL or TLS
438 <xs:element name="PSTN" type="ExtensionOnlyType"/>
439 <xs:element name="ISDN" type="ExtensionOnlyType"/>
440 <xs:element name="ADSL" type="ExtensionOnlyType"/>
442 <xs:element name="OperationalProtection" type="OperationalProtectionType">
445 Refers to those characteristics that describe
446 procedural security controls employed by the Authentication Authority.
451 <xs:element name="SecurityAudit" type="SecurityAuditType"/>
452 <xs:element name="SwitchAudit" type="ExtensionOnlyType"/>
453 <xs:element name="DeactivationCallCenter" type="ExtensionOnlyType"/>
455 <xs:element name="GoverningAgreements" type="GoverningAgreementsType">
458 Provides a mechanism for linking to external (likely
459 human readable) documents in which additional business agreements,
460 (e.g. liability constraints, obligations, etc) can be placed.
465 <xs:element name="GoverningAgreementRef" type="GoverningAgreementRefType"/>
467 <xs:simpleType name="nymType">
468 <xs:restriction base="xs:NMTOKEN">
469 <xs:enumeration value="anonymity"/>
470 <xs:enumeration value="verinymity"/>
471 <xs:enumeration value="pseudonymity"/>
475 <xs:complexType name="AuthnContextDeclarationBaseType">
477 <xs:element ref="Identification" minOccurs="0"/>
478 <xs:element ref="TechnicalProtection" minOccurs="0"/>
479 <xs:element ref="OperationalProtection" minOccurs="0"/>
480 <xs:element ref="AuthnMethod" minOccurs="0"/>
481 <xs:element ref="GoverningAgreements" minOccurs="0"/>
482 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
484 <xs:attribute name="ID" type="xs:ID" use="optional"/>
487 <xs:complexType name="IdentificationType">
489 <xs:element ref="PhysicalVerification" minOccurs="0"/>
490 <xs:element ref="WrittenConsent" minOccurs="0"/>
491 <xs:element ref="GoverningAgreements" minOccurs="0"/>
492 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
494 <xs:attribute name="nym" type="nymType">
497 This attribute indicates whether or not the
498 Identification mechanisms allow the actions of the Principal to be
499 linked to an actual end user.
505 <xs:complexType name="TechnicalProtectionBaseType">
507 <xs:choice minOccurs="0">
508 <xs:element ref="PrivateKeyProtection"/>
509 <xs:element ref="SecretKeyProtection"/>
511 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
515 <xs:complexType name="OperationalProtectionType">
517 <xs:element ref="SecurityAudit" minOccurs="0"/>
518 <xs:element ref="DeactivationCallCenter" minOccurs="0"/>
519 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
523 <xs:complexType name="AuthnMethodBaseType">
525 <xs:element ref="PrincipalAuthenticationMechanism" minOccurs="0"/>
526 <xs:element ref="Authenticator" minOccurs="0"/>
527 <xs:element ref="AuthenticatorTransportProtocol" minOccurs="0"/>
528 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
532 <xs:complexType name="GoverningAgreementsType">
534 <xs:element ref="GoverningAgreementRef" maxOccurs="unbounded"/>
538 <xs:complexType name="GoverningAgreementRefType">
539 <xs:attribute name="governingAgreementRef" type="xs:anyURI" use="required"/>
542 <xs:complexType name="PrincipalAuthenticationMechanismType">
544 <xs:element ref="Password" minOccurs="0"/>
545 <xs:element ref="RestrictedPassword" minOccurs="0"/>
546 <xs:element ref="Token" minOccurs="0"/>
547 <xs:element ref="Smartcard" minOccurs="0"/>
548 <xs:element ref="ActivationPin" minOccurs="0"/>
549 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
551 <xs:attribute name="preauth" type="xs:integer" use="optional"/>
554 <xs:group name="AuthenticatorChoiceGroup">
556 <xs:element ref="PreviousSession"/>
557 <xs:element ref="ResumeSession"/>
558 <xs:element ref="DigSig"/>
559 <xs:element ref="Password"/>
560 <xs:element ref="RestrictedPassword"/>
561 <xs:element ref="ZeroKnowledge"/>
562 <xs:element ref="SharedSecretChallengeResponse"/>
563 <xs:element ref="SharedSecretDynamicPlaintext"/>
564 <xs:element ref="IPAddress"/>
565 <xs:element ref="AsymmetricDecryption"/>
566 <xs:element ref="AsymmetricKeyAgreement"/>
567 <xs:element ref="SubscriberLineNumber"/>
568 <xs:element ref="UserSuffix"/>
569 <xs:element ref="ComplexAuthenticator"/>
573 <xs:group name="AuthenticatorSequenceGroup">
575 <xs:element ref="PreviousSession" minOccurs="0"/>
576 <xs:element ref="ResumeSession" minOccurs="0"/>
577 <xs:element ref="DigSig" minOccurs="0"/>
578 <xs:element ref="Password" minOccurs="0"/>
579 <xs:element ref="RestrictedPassword" minOccurs="0"/>
580 <xs:element ref="ZeroKnowledge" minOccurs="0"/>
581 <xs:element ref="SharedSecretChallengeResponse" minOccurs="0"/>
582 <xs:element ref="SharedSecretDynamicPlaintext" minOccurs="0"/>
583 <xs:element ref="IPAddress" minOccurs="0"/>
584 <xs:element ref="AsymmetricDecryption" minOccurs="0"/>
585 <xs:element ref="AsymmetricKeyAgreement" minOccurs="0"/>
586 <xs:element ref="SubscriberLineNumber" minOccurs="0"/>
587 <xs:element ref="UserSuffix" minOccurs="0"/>
588 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
592 <xs:complexType name="AuthenticatorBaseType">
594 <xs:group ref="AuthenticatorChoiceGroup"/>
595 <xs:group ref="AuthenticatorSequenceGroup"/>
599 <xs:complexType name="ComplexAuthenticatorType">
601 <xs:group ref="AuthenticatorChoiceGroup"/>
602 <xs:group ref="AuthenticatorSequenceGroup"/>
606 <xs:complexType name="AuthenticatorTransportProtocolType">
608 <xs:choice minOccurs="0">
609 <xs:element ref="HTTP"/>
610 <xs:element ref="SSL"/>
611 <xs:element ref="MobileNetworkNoEncryption"/>
612 <xs:element ref="MobileNetworkRadioEncryption"/>
613 <xs:element ref="MobileNetworkEndToEndEncryption"/>
614 <xs:element ref="WTLS"/>
615 <xs:element ref="IPSec"/>
616 <xs:element ref="PSTN"/>
617 <xs:element ref="ISDN"/>
618 <xs:element ref="ADSL"/>
620 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
624 <xs:complexType name="KeyActivationType">
626 <xs:element ref="ActivationPin" minOccurs="0"/>
627 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
631 <xs:complexType name="KeySharingType">
632 <xs:attribute name="sharing" type="xs:boolean" use="required"/>
635 <xs:complexType name="PrivateKeyProtectionType">
637 <xs:element ref="KeyActivation" minOccurs="0"/>
638 <xs:element ref="KeyStorage" minOccurs="0"/>
639 <xs:element ref="KeySharing" minOccurs="0"/>
640 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
644 <xs:complexType name="PasswordType">
646 <xs:element ref="Length" minOccurs="0"/>
647 <xs:element ref="Alphabet" minOccurs="0"/>
648 <xs:element ref="Generation" minOccurs="0"/>
649 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
651 <xs:attribute name="ExternalVerification" type="xs:anyURI" use="optional"/>
654 <xs:element name="RestrictedPassword" type="RestrictedPasswordType"/>
656 <xs:complexType name="RestrictedPasswordType">
658 <xs:restriction base="PasswordType">
660 <xs:element name="Length" type="RestrictedLengthType" minOccurs="1"/>
661 <xs:element ref="Generation" minOccurs="0"/>
662 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
664 <xs:attribute name="ExternalVerification" type="xs:anyURI" use="optional"/>
669 <xs:complexType name="RestrictedLengthType">
671 <xs:restriction base="LengthType">
672 <xs:attribute name="min" use="required">
674 <xs:restriction base="xs:integer">
675 <xs:minInclusive value="3"/>
679 <xs:attribute name="max" type="xs:integer" use="optional"/>
684 <xs:complexType name="ActivationPinType">
686 <xs:element ref="Length" minOccurs="0"/>
687 <xs:element ref="Alphabet" minOccurs="0"/>
688 <xs:element ref="Generation" minOccurs="0"/>
689 <xs:element ref="ActivationLimit" minOccurs="0"/>
690 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
694 <xs:element name="Alphabet" type="AlphabetType"/>
695 <xs:complexType name="AlphabetType">
696 <xs:attribute name="requiredChars" type="xs:string" use="required"/>
697 <xs:attribute name="excludedChars" type="xs:string" use="optional"/>
698 <xs:attribute name="case" type="xs:string" use="optional"/>
701 <xs:complexType name="TokenType">
703 <xs:element ref="TimeSyncToken"/>
704 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
708 <xs:simpleType name="DeviceTypeType">
709 <xs:restriction base="xs:NMTOKEN">
710 <xs:enumeration value="hardware"/>
711 <xs:enumeration value="software"/>
715 <xs:simpleType name="booleanType">
716 <xs:restriction base="xs:NMTOKEN">
717 <xs:enumeration value="true"/>
718 <xs:enumeration value="false"/>
722 <xs:complexType name="TimeSyncTokenType">
723 <xs:attribute name="DeviceType" type="DeviceTypeType" use="required"/>
724 <xs:attribute name="SeedLength" type="xs:integer" use="required"/>
725 <xs:attribute name="DeviceInHand" type="booleanType" use="required"/>
728 <xs:complexType name="ActivationLimitType">
730 <xs:element ref="ActivationLimitDuration"/>
731 <xs:element ref="ActivationLimitUsages"/>
732 <xs:element ref="ActivationLimitSession"/>
736 <xs:element name="ActivationLimitDuration" type="ActivationLimitDurationType">
739 This element indicates that the Key Activation Limit is
740 defined as a specific duration of time.
745 <xs:element name="ActivationLimitUsages" type="ActivationLimitUsagesType">
748 This element indicates that the Key Activation Limit is
749 defined as a number of usages.
754 <xs:element name="ActivationLimitSession" type="ActivationLimitSessionType">
757 This element indicates that the Key Activation Limit is
763 <xs:complexType name="ActivationLimitDurationType">
764 <xs:attribute name="duration" type="xs:duration" use="required"/>
767 <xs:complexType name="ActivationLimitUsagesType">
768 <xs:attribute name="number" type="xs:integer" use="required"/>
771 <xs:complexType name="ActivationLimitSessionType"/>
773 <xs:complexType name="LengthType">
774 <xs:attribute name="min" type="xs:integer" use="required"/>
775 <xs:attribute name="max" type="xs:integer" use="optional"/>
778 <xs:simpleType name="mediumType">
779 <xs:restriction base="xs:NMTOKEN">
780 <xs:enumeration value="memory"/>
781 <xs:enumeration value="smartcard"/>
782 <xs:enumeration value="token"/>
783 <xs:enumeration value="MobileDevice"/>
784 <xs:enumeration value="MobileAuthCard"/>
788 <xs:complexType name="KeyStorageType">
789 <xs:attribute name="medium" type="mediumType" use="required"/>
792 <xs:complexType name="SecretKeyProtectionType">
794 <xs:element ref="KeyActivation" minOccurs="0"/>
795 <xs:element ref="KeyStorage" minOccurs="0"/>
796 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
800 <xs:complexType name="SecurityAuditType">
802 <xs:element ref="SwitchAudit" minOccurs="0"/>
803 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
807 <xs:complexType name="ExtensionOnlyType">
809 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded"/>
813 <xs:element name="Extension" type="ExtensionType"/>
815 <xs:complexType name="ExtensionType">
817 <xs:any namespace="##other" processContents="lax" maxOccurs="unbounded"/>