GAM External Authentication Type can be defined using a SOAP web service or an external program.
In case of using a Web Service (SOAP) it must meet certain requirements in order to be used as GAM External Web Services Authentication Type:
Type GAMWSLoginInSDT : in parameter
Type GAMWSLoginOutSDT: out parameter
In case of GAM Custom Authentication Type, the same data types should be used, except that in this case they are passed to the program as strings in json format.
External authentication program 1.0 data types
Type GAMWSLoginInSDT
Name |
Description |
Type |
GAMUsrLogin |
User identification login |
String |
GAMUsrPwd |
User Password |
String |
GAMUsrAddPar |
Collection of additional parameters |
GAMWSLoginInAddParSDT (Collection) |
Type GAMWSLoginInAddParSDT
Name |
Description |
Type |
GAMAddParId |
Additional parameter identifier |
String |
GAMAddParValue |
Additional parameter value |
String |

Type GAMWSLoginOutSDT
Name |
Description |
Type |
WSVersion |
web service version (1.0) |
String |
WSStatus |
Response status:
1 = User and password ok
2 = Unknown user
3 = Invalid password
4 = User is not active
|
Short |
WSMessage |
Custom message when the user tries to authenticate |
String |
User |
Information of the connected user |
GAMWSLoginOutUserSDT |
Note: WSStatus can be any other value than 1 to 4. Numbers above 4 correspond to custom messages. In that case, the string value in WSMessage will be shown to the user when he tries to login.
Type GAMWSLoginOutUserSDT
Name |
Description |
Type |
Code |
User identifier |
String |
FirstName |
User first name |
String |
LastName |
User last name |
String |
Email |
User email |
String |
Roles |
User roles list |
Collection of RoleItem |
RoleItem has RoleCode (String) child. |

Note: The Code (*) of the user will be mapped to the ExternalId property of GAMUser object when the user registers to the application.
Example of the HTTP response of the webservice 1.0:
<GAMWSLoginOutSDT xmlns="GAM">
<WSVersion>1.0</WSVersion>
<WSStatus>1</WSStatus>
<WSMessage />
<User>
<Code>500</Code>
<FirstName>Juan</FirstName>
<LastName>Perez</LastName>
<EMail>jperez@gxportal.com</EMail>
<Roles>
<GAMWSLoginOutUserSDT.RoleItem>
<RoleCode>4</RoleCode>
</GAMWSLoginOutUserSDT.RoleItem>
<GAMWSLoginOutUserSDT.RoleItem>
<RoleCode>10</RoleCode>
</GAMWSLoginOutUserSDT.RoleItem>
<GAMWSLoginOutUserSDT.RoleItem>
<RoleCode>15</RoleCode>
</GAMWSLoginOutUserSDT.RoleItem>
</Roles>
</User>
</GAMWSLoginOutSDT>
Download
-
xpz of the web service 1.0 sample here
-
wsdl of the web service 1.0 sample here
See also
GAM External Authentication: version 2.0