MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

SignOn::IdentityInfo Class Reference

Contains identity information. More...

List of all members.

Public Types

enum   CredentialsType { Other = 0, Application = 1 << 0, Web = 1 << 1, Network = 1 << 2 }
 

Values used to describe the type of the identity.

More...

Public Member Functions

  IdentityInfo ()
  Creates a new empty IdentityInfo object.
  IdentityInfo (const IdentityInfo &other)
  Copy constructor.
IdentityInfo operator= (const IdentityInfo &other)
  Assignment operator.
  IdentityInfo (const QString &caption, const QString &userName, const QMap< MethodName, MechanismsList > &methods)
  Creates a new IdentityInfo object with given values.
  ~IdentityInfo ()
  Destructor.
quint32  id () const
  Returns the identity identifier.
void  setSecret (const QString &secret, const bool storeSecret=true)
  Sets the secret.
bool  isStoringSecret () const
  Returns whether secret is to be stored.
void  setStoreSecret (const bool storeSecret)
  Sets whether the secret is stored or not.
void  setUserName (const QString &userName)
  Sets the username.
const QString  userName () const
  Returns the username.
void  setCaption (const QString &caption)
  Sets a human readable caption of the identity.
const QString  caption () const
  Returns a human-readable representation of the identity.
void  setRealms (const QStringList &realms)
  Sets the realms, e.g.
QStringList  realms () const
  Gets the realms, e.g.
void  setOwner (const QString &ownerToken)
  Sets application token that owns identity, therefore defining the applications that will be able to modify this specific set of credentials.
QString  owner () const
  Gets the owner application token that is defining the applications that are able to modify this specific set of credentials.
void  setAccessControlList (const QStringList &accessControlList)
  Sets the list of access control application tokens, therefore defining the applications that will be able to access this specific set of credentials.
QStringList  accessControlList () const
  Gets the list of access control application tokens defining the applications that are able to access this specific set of credentials.
void  setMethod (const MethodName &method, const MechanismsList &mechanismsList)
  Sets the method into identity info.
void  removeMethod (const MethodName &method)
  Removes a method from identity info.
void  setType (CredentialsType type)
  Sets the type into identity info.
CredentialsType  type () const
  Retrieves the identity type from identity info.
QList< MethodName methods () const
  Lists all methods in identity info.
MechanismsList  mechanisms (const MethodName &method) const
  Lists the all mechanisms for certain method in identity info.
void  setRefCount (qint32 refCount)
  Sets the refcount into identity info.
qint32  refCount () const
  Retrieves the refcount from identity info.

Detailed Description

Contains identity information.

This information is stored into database.

See also:
queryIdentities()

Member Enumeration Documentation

Values used to describe the type of the identity.

Attention:
Mixed types, i.e Application|Web are not yet supported. Just single types work for the time being.

Constructor & Destructor Documentation

SignOn::IdentityInfo::IdentityInfo ( const QString caption,
const QString userName,
const QMap< MethodName, MechanismsList > &  methods  
)

Creates a new IdentityInfo object with given values.

Parameters:
caption  Description of identity
userName  Username
methods  Allowed methods for identity

Member Function Documentation

QStringList SignOn::IdentityInfo::accessControlList (  )  const

Gets the list of access control application tokens defining the applications that are able to access this specific set of credentials.

Attention:
This is accessible only to the owner application.
Returns:
The access control tokens which defines the applications allowed to access this set of credentials.
const QString SignOn::IdentityInfo::caption (  )  const

Returns a human-readable representation of the identity.

Returns:
Human-readable representation of the identity.
quint32 SignOn::IdentityInfo::id (  )  const

Returns the identity identifier.

Returns:
Identifier for the identity
bool SignOn::IdentityInfo::isStoringSecret (  )  const

Returns whether secret is to be stored.

Returns:
true Whether the secret is being stored or not.
MechanismsList SignOn::IdentityInfo::mechanisms ( const MethodName method  )  const

Lists the all mechanisms for certain method in identity info.

Parameters:
method  Method name to list mechanisms
Returns:
List of mechanisms
QList<MethodName> SignOn::IdentityInfo::methods (  )  const

Lists all methods in identity info.

Returns:
Param method method name to remove.
QString SignOn::IdentityInfo::owner (  )  const

Gets the owner application token that is defining the applications that are able to modify this specific set of credentials.

Attention:
This is accessible only to the owner application.
Returns:
The access control token which defines the applications allowed to modify this set of credentials.
QStringList SignOn::IdentityInfo::realms (  )  const

Gets the realms, e.g.

URL's with which the Identity using this IdentityInfo works with.

Returns:
List of supported realms.
qint32 SignOn::IdentityInfo::refCount (  )  const

Retrieves the refcount from identity info.

Returns:
Refcount for this IdentityInfo
void SignOn::IdentityInfo::removeMethod ( const MethodName method  ) 

Removes a method from identity info.

Parameters:
method  Method name to remove
void SignOn::IdentityInfo::setAccessControlList ( const QStringList accessControlList  ) 

Sets the list of access control application tokens, therefore defining the applications that will be able to access this specific set of credentials.

Parameters:
accessControlList  List of access control tokens
void SignOn::IdentityInfo::setCaption ( const QString caption  ) 

Sets a human readable caption of the identity.

Parameters:
caption  Caption
void SignOn::IdentityInfo::setMethod ( const MethodName method,
const MechanismsList mechanismsList  
)

Sets the method into identity info.

If the given method is not included, a new one will be added. If it is already set, the mechanism list assosiated to it is updated. an empty list will clear the mechanisms. These values are used to limit Identity to use the specified methods and mechanisms.

Parameters:
method  Method name to change
mechanismsList  list of mechanisms that are allowed
void SignOn::IdentityInfo::setOwner ( const QString ownerToken  ) 

Sets application token that owns identity, therefore defining the applications that will be able to modify this specific set of credentials.

Parameters:
ownerToken  owner token
void SignOn::IdentityInfo::setRealms ( const QStringList realms  ) 

Sets the realms, e.g.

URL's with which the Identity using this IdentityInfo shall work with.

Parameters:
realms  List of the realms to be set.
void SignOn::IdentityInfo::setRefCount ( qint32  refCount  ) 

Sets the refcount into identity info.

The type is used to generically identify where this identity is being used.

Note:
Server can restrict changes to differ +-1 from previous.
Parameters:
refCount  Set refcount
void SignOn::IdentityInfo::setSecret ( const QString secret,
const bool  storeSecret = true  
)

Sets the secret.

When performing a challenge on the owner Identity object, if the secret is set on its corresponding IdentityInfo, it will be added to the parameter list that is passed to the corresponding authentication plugin challenge implementation. By default a newly created IdentityInfo does not contain a secret and has a policy of not storing any. If the secret is set the default policy will be to store it. This behaviour can also be set with IdentityInfo::setStoreSecret().

See also:
PluginInterface::secretKey
PluginInterface::challenge
Parameters:
secret 
storeSecret  Whether the secret is stored or not
void SignOn::IdentityInfo::setStoreSecret ( const bool  storeSecret  ) 

Sets whether the secret is stored or not.

Parameters:
storeSecret  Whether the secret must be stored in the DB.
void SignOn::IdentityInfo::setType ( CredentialsType  type  ) 

Sets the type into identity info.

The type is used to generically identify where this identity is being used.

Attention:
If this method is not called, the IdentityInfo type will default to SignOn::OtherIdentity.
Parameters:
type  Type we want to assign to this IdentityInfo
void SignOn::IdentityInfo::setUserName ( const QString userName  ) 

Sets the username.

See also:
userNameKey
Parameters:
userName  Username
CredentialsType SignOn::IdentityInfo::type (  )  const

Retrieves the identity type from identity info.

Returns:
The identity type for this IdentityInfo
const QString SignOn::IdentityInfo::userName (  )  const

Returns the username.

Returns:
Username for the identity

Copyright (C) 2009-2011 Nokia Corporation.
LGPL
MeeGo 1.2 Harmattan API