LassoSaml2NameID

## LassoSaml2NameID LassoSaml2NameID — <saml2:NameID> |

## Synopsis

    struct              LassoSaml2NameID;
    LassoNode *         lasso_saml2_name_id_new             (void);
    LassoNode *         lasso_saml2_name_id_new_with_string (char *content);
    LassoSaml2NameID *  lasso_saml2_name_id_build_persistent
                                                            (const char *id,
                                                             const char *idpID,
                                                             const char *providerID);
    gboolean            lasso_saml2_name_id_equals          (LassoSaml2NameID *name_id,
                                                             LassoSaml2NameID *other_name_id);
    LassoSaml2NameID *  lasso_saml2_name_id_new_with_persistent_format
                                                            (const char *id,
                                                             const char *idpID,
                                                             const char *providerID);

## Description

Figure 58. Schema fragment for saml2:NameID

    <complexType name="NameIDType">
      <simpleContent>
        <extension base="string">
          <attributeGroup ref="saml:IDNameQualifiers"/>
          <attribute name="Format" type="anyURI" use="optional"/>
          <attribute name="SPProvidedID" type="string" use="optional"/>
        </extension>
      </simpleContent>
    </complexType>

## Details

### struct LassoSaml2NameID

    struct LassoSaml2NameID {
    	LassoNode parent;

    	/* elements */
    	char *content;
    	/* attributes */
    	char *Format;
    	char *SPProvidedID;
    	char *NameQualifier;
    	char *SPNameQualifier;
    };

### lasso_saml2_name_id_new ()

    LassoNode *         lasso_saml2_name_id_new             (void);

Creates a new LassoSaml2NameID object.

Returns : | a newly created LassoSaml2NameID object

### lasso_saml2_name_id_new_with_string ()

    LassoNode *         lasso_saml2_name_id_new_with_string (char *content);

Creates a new LassoSaml2NameID object and initializes it with `content`. Beware that no format is set.

`content` : | the Name Identifier.
Returns : | a newly created LassoSaml2NameID object

### lasso_saml2_name_id_build_persistent ()

    LassoSaml2NameID *  lasso_saml2_name_id_build_persistent
                                                            (const char *id,
                                                             const char *idpID,
                                                             const char *providerID);

### Warning

`lasso_saml2_name_id_build_persistent` has been deprecated since version 2.3 and should not be used in newly-written code. use `lasso_saml2_name_id_new_with_persistent_format()` instead.

Create a new LassoSaml2NameID object, which the LASSO_SAML2_NAME_IDENTIFIER_FORMAT_PERSISTENT format, `id` as content, `idpID` as NameQualifier and `providerID` as SPNameQualifier.

`id` : | the identifier for the princiapl
`idpID` : | the entity ID of the IdP
`providerID` : | the entity ID of the provider
Returns : | a newly created LassoSaml2NameID

### lasso_saml2_name_id_equals ()

    gboolean            lasso_saml2_name_id_equals          (LassoSaml2NameID *name_id,
                                                             LassoSaml2NameID *other_name_id);

Return TRUE if `name_id` equals `other_name_id`.

`name_id` : | a LassoSaml2NameID object
`other_name_id` : | another LassoSaml2NameID object
Returns : | TRUE if the two NameID are equal and are LassoSaml2NameID objects, FALSE otherwise.

### lasso_saml2_name_id_new_with_persistent_format ()

    LassoSaml2NameID *  lasso_saml2_name_id_new_with_persistent_format
                                                            (const char *id,
                                                             const char *idpID,
                                                             const char *providerID);

Create a new LassoSaml2NameID object, which the LASSO_SAML2_NAME_IDENTIFIER_FORMAT_PERSISTENT format, `id` as content, `idpID` as NameQualifier and `providerID` as SPNameQualifier.

`id` : | the identifier for the princiapl
`idpID` : | the entity ID of the IdP
`providerID` : | the entity ID of the provider
Returns : | a newly created LassoSaml2NameID

Since 2.3