[KnownType(typeof(X509CertificateIdentityDefinition))]
[KnownType(typeof(X509CertificateIdentityDefinitionBase))]
[KnownType(typeof(X509CertificateFederationIdentityDefinition))]
[KnownType(typeof(X509CertificateThumbprintIdentityDefinition))]
[KnownType(typeof(UpnIdentityDefinition))]
[KnownType(typeof(SpnIdentityDefinition))]
[KnownType(typeof(UserNameIdentityDefinition))]
[KnownType(typeof(UserNamePasswordHashIdentityDefinition))]
[KnownType(typeof(WindowsIdentityDefinition))]
[KnownType(typeof(WindowsNoPasswordIdentityDefinition))]
[KnownType(typeof(WindowsGroupIdentityDefinition))]
[KnownType(typeof(AzureIdentityDefinition))]
[KnownType(typeof(DnsIdentityDefinition))]
[KnownType(typeof(ClaimIdentityDefinition))]
[KnownType(typeof(OAuthClientIdentityDefinition))]
[KnownType(typeof(OAuthServiceIdentityDefinition))]
[KnownType(typeof(ReferenceIdentityDefinition))]
[DataContract(Namespace = "http://schemas.nevatech.com/sentinet/2011/02")]
public abstract class IdentityDefinitionBase : IValidator, IExtensibleDataObject

Constructors

IdentityDefinitionBase()

Initializes an empty instance.

Declaration

protected IdentityDefinitionBase()

IdentityDefinitionBase(Identity)

Initializes new instance from provided Identity object.

Declaration

[SuppressMessage("Microsoft.Usage", "CA2214:DoNotCallOverridableMethodsInConstructors")]
protected IdentityDefinitionBase(Identity identity)

Parameters

Type	Name	Description
Identity	identity	Identity object used to populate new instance.

Properties

Created

Gets this object's created date and time.

Declaration

[DataMember]
public DateTime Created { get; protected set; }

Property Value

Type	Description
DateTime

Description

Gets or sets the identity description.

Declaration

[DataMember(EmitDefaultValue = false)]
public string Description { get; set; }

Property Value

Type	Description
string

ErrorMessage

Gets the summary of validation errors populated by the call to Validate() method.

Declaration

public string ErrorMessage { get; protected set; }

Property Value

Type	Description
string

Expired

Gets or sets the UTC date and time when identity expires and can no longer be used. If Null, then identity never expires.

Declaration

[DataMember(EmitDefaultValue = false)]
public DateTime? Expired { get; set; }

Property Value

Type	Description
DateTime?

ExtensionData

Gets or sets ExtensionDataObject that enables serialization round-trips.

Declaration

public ExtensionDataObject ExtensionData { get; set; }

Property Value

Type	Description
ExtensionDataObject

FolderId

Gets or sets identifier of folder that identity belongs to.

Declaration

[DataMember(EmitDefaultValue = false)]
public int? FolderId { get; set; }

Property Value

Type	Description
int?

FriendlyName

Gets or sets the friendly name describing stored identity.

Declaration

[DataMember]
public abstract string FriendlyName { get; set; }

Property Value

Type	Description
string

Id

Gets or sets identity's database identifier.

Declaration

[DataMember]
public int Id { get; set; }

Property Value

Type	Description
int

IsEndpointIdentity

Gets flag indicating that identity can be used to create EndpointIdentity.

Declaration

public virtual bool IsEndpointIdentity { get; }

Property Value

Type	Description
bool

IsPublic

Gets or sets flag telling that identity is public and can be shared across multiple endpoints. This property cannot be changed for an existing identity.

Declaration

[DataMember(EmitDefaultValue = false)]
public bool IsPublic { get; set; }

Property Value

Type	Description
bool

Key

Gets or sets identity's unique identifier.

Declaration

[DataMember(EmitDefaultValue = false)]
public Guid Key { get; set; }

Property Value

Type	Description
Guid

Kind

Gets stored identity kind (like X.509 certificate, SPN, etc).

Declaration

[DataMember]
public abstract IdentityKind Kind { get; protected set; }

Property Value

Type	Description
IdentityKind

Updated

Gets this object's updated date and time.

Declaration

[DataMember(EmitDefaultValue = false)]
public DateTime? Updated { get; protected set; }

Property Value

Type	Description
DateTime?

Methods

Create(Identity)

Returns an instance of specific identity definition populated from provided Identity object.

Declaration

public static IdentityDefinitionBase Create(Identity identity)

Parameters

Type	Name	Description
Identity	identity	Identity used to populate specific identity definition.

Returns

Type	Description
IdentityDefinitionBase	Instance of specific identity definition populated from provided Identity object.

Create(EndpointIdentity)

Returns an instance of specific service identity definition populated from provided EndpointIdentity object.

Declaration

public static IdentityDefinitionBase Create(EndpointIdentity identity)

Parameters

Type	Name	Description
EndpointIdentity	identity	Endpoint identity used to populate specific identity definition.

Returns

Type	Description
IdentityDefinitionBase	Instance of specific service identity definition populated from provided EndpointIdentity object.

GetConfiguration()

Returns endpoint <identity/> configuration element corresponding to the identity stored in this instance. This method is applied to service identities only.

Declaration

[SuppressMessage("Microsoft.Design", "CA1024:UsePropertiesWhereAppropriate")]
public virtual string GetConfiguration()

Returns

Type	Description
string	Endpoint <identity/> configuration element corresponding to the identity stored in this instance.

Exceptions

Type	Condition
NotSupportedException	Thrown, if this method is called on the client identity type.

GetEndpointIdentity()

Returns EndpointIdentity object populated with the data stored in this instance. This method is applied to service identities only.

Declaration

[SuppressMessage("Microsoft.Design", "CA1024:UsePropertiesWhereAppropriate")]
public virtual EndpointIdentity GetEndpointIdentity()

Returns

Type	Description
EndpointIdentity	EndpointIdentity object populated with the data stored in this instance.

Exceptions

Type	Condition
NotSupportedException	Thrown, if this method is called on the client identity type.

GetIdentity()

Returns Identity object populated with the data stored in this instance. The returned object can be used to persist identity data to database.

Declaration

[SuppressMessage("Microsoft.Design", "CA1024:UsePropertiesWhereAppropriate")]
public virtual Identity GetIdentity()

Returns

Type	Description
Identity	Identity object populated with the data stored in this instance.

IsMatch(IdentityDefinitionBase, IdentityDefinitionBase)

Returns flag indicating that provided instances represent the same entity, i.e. the object's natural keys are the same. This method assumes that both instances are assigned to the same parent object.

Declaration

public static bool IsMatch(IdentityDefinitionBase identity1, IdentityDefinitionBase identity2)

Parameters

Type	Name	Description
IdentityDefinitionBase	identity1	First instance to be compared.
IdentityDefinitionBase	identity2	Second instance to be compared.

Returns

Type	Description
bool	True, if provided instances represent the same entity. False, otherwise.

ToString()

Returns the current credentials display name.

Declaration

public override string ToString()

Returns

Type	Description
string	The current credentials display name.

Overrides

object.ToString()

Validate()

Validates this domain object's state.

Declaration

public virtual bool Validate()

Returns

Type	Description
bool	True if object's state is valid; otherwise, false.

Validate(bool)

Validates this domain object's state.

Declaration

public bool Validate(bool throwOnError)

Parameters

Type	Name	Description
bool	throwOnError	Flag indicating that ValidationException must be thrown, if entity is not valid.

Returns

Type	Description
bool	True if object's state is valid; otherwise, false.

Implements

IValidator

IExtensibleDataObject