The Official
Website of the
International
Sailing Federation

isaf.com

ISAF XRR Member Authentication

The sailor authentication service is provided as a means for 3rd party software applications and web-sites to allow users to log-in to their local systems using each persons unique Sailor ID.
Authenticating website members against the ISAF database requires that communication is performed over the Secure Sockets Layer (SSL), and that it is encapsulated in the ISAF XRR document format.
All communication for member authentication must be conducted through the URL:

Member Authentication Process

In order to submit login credentials to the authentication service an XRR document must be generated to represent the member as in the following example:

<?xml version="1.0" encoding="UTF-8"?>

<SailingXRR xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" DateTime="2013-09-05T11:29:07" Type="SailingXRR" Version="1.3.1" xsi:noNamespaceSchemaLocation="http://www.sailing.org/techpages/resources/xml/sailingXRR_v1.3.1.xsd">

    <Person PersonID="GBRTT43" FamilyName="" IFPersonID="GBRTT43">

        <Other Name="password" Value="testpass01" />

    </Person>

</SailingXRR>

A connection is made by the client software using a standard HTTP connection - specific to the framework libraries that support your chosen programming language.
All communication objects should be set up to use UTF-8 encoding and the document content passed to the above URL using the HTTP(S) POST mechanism. The following files contain examples of this implemented in a number of languages:

Authentication Results

There are 3 possible outcomes from an authentication request:
  • The member has been sucessfully authenticated

    <?xml version="1.0" encoding="UTF-8"?>

    <SailingXRR xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.sailing.org/techpages/resources/xml/sailingXRR_v1.3.1.xsd" Version="1.3.1" Type="SailingXRR" DateTime="2013-09-13T10:40:460">

        <Person PersonID="44369" IFPersonID="GBRTT43" FamilyName="Test" GivenName="Test" NOC="GBR" Gender="F" ClassificationStatus="None">

            <Other Name="ISAFBiogUrl" Value="http://www.sailing.org/sailors/biog.php?isafid=GBRTT43"/>

            <Other Name="ISAFResultsURL" Value="http://www.sailing.org/sailors/biog.php?isafid=GBRTT43&amp;panel=results#content"/>

            <Other Name="authenticated" Value="1"/>

        </Person>

    </SailingXRR>

  • The member was not sucessfully authenticated (incorrect password)

    <?xml version="1.0" encoding="UTF-8"?>

    <SailingXRR xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.sailing.org/techpages/resources/xml/sailingXRR_v1.3.1.xsd" Version="1.3.1" Type="SailingXRR" DateTime="2013-09-13T10:37:580">

        <Person PersonID="44369" IFPersonID="GBRTT43" FamilyName="Test" GivenName="Test" NOC="GBR" Gender="F" ClassificationStatus="None">

            <Other Name="ISAFBiogUrl" Value="http://www.sailing.org/sailors/biog.php?isafid=GBRTT43"/>

            <Other Name="ISAFResultsURL" Value="http://www.sailing.org/sailors/biog.php?isafid=GBRTT43&amp;panel=results#content"/>

            <Other Name="authenticated" Value="0"/>

        </Person>

    </SailingXRR>

  • The member account was not recognised (incorrect Sailor ID)

    <?xml version="1.0" encoding="UTF-8"?>

    <SailingXRR xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.sailing.org/techpages/resources/xml/sailingXRR_v1.3.1.xsd" Version="1.3.1" Type="SailingXRR" DateTime="2013-09-13T10:41:560">

        <Person PersonID="" IFPersonID="" FamilyName="" GivenName="" ClassificationStatus="None">

            <Other Name="authenticated" Value="0"/>

        </Person>

    </SailingXRR>

© 2014 Copyright ISAF/ISAF UK Ltd. All Rights Reserved Privacy & Cookies delivered by Sotic powered by OpenText WSM