Convenzioni dello schema di configurazione di WIFWIF Configuration Schema Conventions

Questo argomento illustra le convenzioni usate negli argomenti relativi alla configurazione di Windows Identity Foundation (WIF) e descrive alcuni attributi e funzionalità comuni usati nelle sezioni <system.identityModel> e <system.identityModel.services>.This topic discusses conventions used throughout the Windows Identity Foundation (WIF) configuration topics and describes some common features and attributes used in the <system.identityModel> and the <system.identityModel.services> sections.

ModalitàModes

Molti elementi di configurazione WIF hanno un attributo mode.Many of the WIF configuration elements have a mode attribute. Questo attributo controlla in genere la classe usata per eseguire una determinata parte dell'elaborazione e gli elementi di configurazione consentiti come elementi figlio dell'elemento corrente.This attribute typically controls which class is used to do a particular part of the processing and which configuration elements are allowed as child elements of the current element. Viene generato un errore di configurazione se gli elementi inclusi nel file di configurazione vengono ignorati a causa delle impostazioni della modalità.A configuration error will be raised if elements that are included in the configuration file are ignored because of the mode settings.

Valori TimeSpanTimespan Values

Quando TimeSpan viene usato come tipo di attributo, vedere il metodo Parse(String) per conoscere il formato consentito.Where TimeSpan is used as the type of an attribute, see the Parse(String) method to see the allowed format. Il formato è conforme alle specifiche seguenti.This format conforms to the following specification.

[ws][-]{ d | [d.]hh:mm[:ss[.ff]] }[ws]  

Ad esempio, "30", "30.00:00", "30.00:00:00" indicano tutti 30 giorni e "00:05", "00:05:00", "0.00:05:00.00" indicano tutti 5 minuti.For example, "30", "30.00:00", "30.00:00:00" all mean 30 days; and "00:05", "00:05:00", "0.00:05:00.00" all mean 5 minutes.

Riferimenti ai certificatiCertificate References

Diversi elementi accettano riferimenti ai certificati tramite l'elemento <certificateReference>.Several elements take references to certificates using the <certificateReference> element. Quando si fa riferimento a un certificato, sono disponibili gli attributi seguenti.When referencing a certificate, the following attributes are available.

storeLocation Un valore dell'enumerazione StoreLocation: CurrentUser o CurrentMachine.A value of the StoreLocation enumeration: CurrentUser or CurrentMachine.
storeName Un valore dell'enumerazione StoreName. I valori più utili in questo contesto sono My e TrustedPeople.A value of the StoreName enumeration; the most useful for this context are My and TrustedPeople.
x509FindType Un valore dell'enumerazione X509FindType. I valori più utili in questo contesto sono FindBySubjectName e FindByThumbprint.A value of the X509FindType enumeration; the most useful for this context are FindBySubjectName and FindByThumbprint. Per eliminare le probabilità di errore, è consigliabile usare il tipo FindByThumbprint in ambienti di produzione.To eliminate the chance of error, it is recommended that the FindByThumbprint type be used in production environments.
findValue Il valore usato per trovare il certificato, basato sull'attributo x509FindType.The value used to find the certificate, based on the x509FindType attribute. Per eliminare le probabilità di errore, è consigliabile usare il tipo FindByThumbprint in ambienti di produzione.To eliminate the chance of error, it is recommended that the FindByThumbprint type be used in production environments. Quando si specifica FindByThumbPrint, questo attributo accetta un valore che è la forma di stringa esadecimale dell'identificazione personale del certificato, ad esempio "97249e1a5fa6bee5e515b82111ef524a4c91583f".When FindByThumbPrint is specified, this attribute takes a value that is the hexadecimal-string form of the certificate thumbprint; for example, "97249e1a5fa6bee5e515b82111ef524a4c91583f".

Riferimenti ai tipi personalizzatiCustom Type References

Diversi elementi fanno riferimento ai tipi personalizzati usando l'attributo type.Several elements reference custom types using the type attribute. Questo attributo deve specificare il nome del tipo personalizzato.This attribute should specify the name of the custom type. Per fare riferimento a un tipo dalla Global Assembly Cache (GAC), è necessario usare un nome sicuro.To reference a type from the Global Assembly Cache (GAC), a strong name should be used. Per fare riferimento a un tipo da un assembly nella directory Bin/, è possibile usare un semplice riferimento qualificato dall'assembly.To reference a type from an assembly in the Bin/ directory, a simple assembly-qualified reference may be used. È possibile fare riferimento anche ai tipi definiti nella directory App_Code/ specificando semplicemente il nome del tipo senza qualifica tramite assembly.Types defined in the App_Code/ directory may also be referenced by simply specifying the type name with no qualifying assembly.

I tipi personalizzati devono essere derivati dal tipo specificato e devono fornire un costruttore public predefinito (argomento 0).Custom types must be derived from the type specified and they must provide a public default (0 argument) constructor.

Vedere ancheSee Also

<System. IdentityModel ><system.identityModel>
<system.identityModel.services><system.identityModel.services>