Warning:
This wiki has been archived and is now read-only.

SOCML:Identity

From Federated Social Web Incubator Group
Jump to: navigation, search

XML

<?xml version="1.0" encoding="UTF-8" ?>
<socml version="1.0">
<identity>
    <guid></guid>
    <firstname></firstname>
    <lastname></lastname>
    <service>
        ...
    </service>
    <!-- Optional -->
    <location></location>
    <publickey></publickey>
    <thumbnail></thumbnail>
</identity>
</socml>

Abstract

The identity object is the core attribute that identifies each social media object with a designated user. The core identity object will, at a minimum, will be able to identify a user and their service location. Additionally, the identity object will have a number of optional fields that can be filled out to provide more public information should the user decide to make them available.

The required fields are a GUID, user first and last name, and the service location where the user can be located. More information on the service object can be found here (content missing).

Required Fields

GUID

XML Tag:

 
    <guid></guid>
    <!-- or as a nested attribute -->
    <identity guid="" />


Description:
The GUID is a unique identifier that should help identify the user across multiple social networks.

A globally unique identifier is a unique reference number used as an identifier in computer software. The term GUID typically refers to various implementations of the universally unique identifier (UUID) standard.

GUIDs are usually stored as 128-bit values, and are commonly displayed as 32 hexadecimal digits with groups separated by hyphens, such as 21EC2020-3AEA-1069-A2DD-08002B30309D. GUIDs generated from random numbers contain 6 fixed bits saying they are random and 122 random bits; the total number of unique such GUIDs is 2122 or 5.3×1036. This number is so large that the probability of the same number being generated randomly twice is negligible; however other GUID versions have different uniqueness properties and probabilities, ranging from guaranteed uniqueness to likely non-uniqueness.

GUIDs can be easily generated and are widely implemented in all the major programming languages.

For more information on GUIDs please visit the wikipage where this information was copied from: Wikipedia: GUID

First Name

XML Tag:

 
    <firstname></firstname>
    <!-- or as a nested attribute -->
    <identity firstname="" />


Description:
This is the user's given first name. This field will be visible to all on every attached object that the user shares, additionally this field will also be shown to those not in the users network when the user interacts with an object not owned by that user. Such an example would be commenting on another user's status.

Last Name

XML Tag:

 
    <lastname></lastname>
    <!-- or as a nested attribute -->
    <identity lastname="" />


Description:
This is the user's given last name. This field will be visible to all on every attached object that the user shares, additionally this field will also be shown to those not in the users network when the user interacts with an object not owned by that user. Such an example would be commenting on another user's status.

Host Service

XML Tag:

 
    <service></service>


Description:
The service field contains all the endpoint information for connecting to the identities service provider. See the Service Object for more information.

Optional Fields

Location

XML Tag:

 
    <location></location>


Description:
The location field is an object described in the SOCML standard. This field will be visible to all on every attached object that the user shares, additionally this can be shown to those not in the users network when the user interacts with an object not owned by that user. Such an example would be commenting on another user's status.

Public Key

XML Tag:

 
    <publickey></publickey>
    <!-- or as a nested attribute -->
    <identity publickey="" />


Description:
If alternative methods of encryption are needed, this field will provide the public key for the user.

Thumbnail

XML Tag:

 
    <thumbnail></thumbnail>
    <!-- or as a nested attribute -->
    <identity thumbnail="" />


Description:
Location where a public image of the user can be found.

Example

<?xml version="1.0" encoding="UTF-8" ?>
<socml version="1.0">
<identity>
    <guid>21EC2020-3AEA-1069-A2DD-08002B30309D</guid>
    <firstname>John</firstname>
    <lastname>Doe</lastname>
    <location>
        <country>USA</country>
        <region>NY</region>
        <city>New York</city>
    </location>
    <publickey>
        3048 0241 00C9 18FA CF8D EB2D EFD5 FD37 89B9 A069 EA97 FC20 5E35 F577 EE31 C4FB C6E4 4811 
        7D86 BC8F BAFA 322F 922B F01B 2F40 C744 2654 C0FD 2881 D673 CA2B 4003 C266 E2CD CB02 0301 0001
    </publickey>
    <thumbnail>http://[your service]/user?guid=21EC2020-3AEA-1069-A2DD-08002B30309D</thumbnail>
    <service>
        ...
    </service>
</identity>
</socml>