Top |
SignonIdentityInfo represents data contained in a database record for an identity and provides getters and setters for individual items.
See SignonIdentity for a detailed discussion of what each item means and how and when it's used.
SignonIdentityInfo * signon_identity_info_new ();
Creates a new SignonIdentityInfo item.
void
signon_identity_info_free (SignonIdentityInfo *info
);
Destroys the given SignonIdentityInfo item.
SignonIdentityInfo *
signon_identity_info_copy (const SignonIdentityInfo *other
);
Get a newly-allocated copy of info
.
gint
signon_identity_info_get_id (const SignonIdentityInfo *info
);
Get the numeric identity ID of info
.
const gchar *
signon_identity_info_get_username (const SignonIdentityInfo *info
);
Get the username associated with an identity.
gboolean
signon_identity_info_get_storing_secret
(const SignonIdentityInfo *info
);
Get whether the secret of info
should be stored by gSSO in the secret database.
const gchar *
signon_identity_info_get_caption (const SignonIdentityInfo *info
);
Get the display name of info
.
GHashTable *
signon_identity_info_get_methods (const SignonIdentityInfo *info
);
Get a hash table of the methods and mechanisms of info
. See
signon_identity_info_set_methods()
.
const gchar * const *
signon_identity_info_get_realms (const SignonIdentityInfo *info
);
Get an array of the allowed realms of info
.
const SignonSecurityContext *
signon_identity_info_get_owner (const SignonIdentityInfo *info
);
Get identity owner's security context.
GList *
signon_identity_info_get_access_control_list
(const SignonIdentityInfo *info
);
Get an access control list associated with an identity.
SignonIdentityType
signon_identity_info_get_identity_type
(const SignonIdentityInfo *info
);
Get the type of the identity.
void signon_identity_info_set_username (SignonIdentityInfo *info
,const gchar *username
);
Sets the username for the identity.
void signon_identity_info_set_secret (SignonIdentityInfo *info
,const gchar *secret
,gboolean store_secret
);
Sets the secret (password) for the identity, and whether the gSSO daemon should remember it.
info |
the SignonIdentityInfo. |
|
secret |
the secret. |
|
store_secret |
whether signond should store the secret in its DB. |
void signon_identity_info_set_caption (SignonIdentityInfo *info
,const gchar *caption
);
Sets the caption (display name) for the identity.
void signon_identity_info_set_methods (SignonIdentityInfo *info
,GHashTable *methods
);
Set authentication methods that are allowed to be used with this identity.
void signon_identity_info_own_methods (SignonIdentityInfo *info
,GHashTable *methods
);
Set authentication methods that are allowed to be used with this identity.
This function will just increment reference count of hash table, so it should be constructed with g_hash_table_new_full.
void signon_identity_info_set_method (SignonIdentityInfo *info
,const gchar *method
,const gchar * const *mechanisms
);
Adds a method to the list of allowed authentication methods.
info |
the SignonIdentityInfo. |
|
method |
an authentication method. |
|
mechanisms |
a |
[array zero-terminated=1] |
void signon_identity_info_remove_method (SignonIdentityInfo *info
,const gchar *method
);
Remove method
from the list of allowed authentication methods.
void signon_identity_info_set_realms (SignonIdentityInfo *info
,const gchar * const *realms
);
Specify what realms this identity can be used in.
info |
the SignonIdentityInfo. |
|
realms |
a |
[array zero-terminated=1] |
void signon_identity_info_set_owner (SignonIdentityInfo *info
,const SignonSecurityContext *owner
);
Set identity owner's security context.
void signon_identity_info_set_owner_from_values (SignonIdentityInfo *info
,const gchar *system_context
,const gchar *application_context
);
Set identity owner's security context.
info |
the SignonIdentityInfo. |
|
system_context |
owner's system context. |
|
application_context |
owner's application context. |
void signon_identity_info_set_access_control_list (SignonIdentityInfo *info
,GList *access_control_list
);
Set an access control list associated with an identity.
info |
the SignonIdentityInfo. |
|
access_control_list |
a list of ACL security contexts. |
[element-type SignonSecurityContext] |
void signon_identity_info_access_control_list_append (SignonIdentityInfo *info
,SignonSecurityContext *security_context
);
Appends a new SignonSecurityContext item to the access control list.
info |
the SignonIdentityInfo. |
|
security_context |
a security context to be appended. |
[transfer full] |
void signon_identity_info_set_identity_type (SignonIdentityInfo *info
,SignonIdentityType type
);
Specifies the type of this identity.