Autenticazione presso l'API SoftLayer

username che contiene il nome utente portale/API e apiKey che contiene la chiave di accesso all'API. Se non viene fornita l'intestazione di autenticazione l'API restituisce l'eccezione "Nessuna intestazione di autenticazione valida trovata." e se si fornisce una combinazione di nome utente e apikey non valida, l'API restituisce l'eccezione "Token API non valido".

Una rappresentazione SOAP dell'intestazione authenticate è simile alla seguente:

<authenticate xsi:type="slt:authenticate" xmlns:slt="http://api.service.softlayer.com/soap/v3/SLTypes/">
    <username xsi:type="xsd:string">MY_USERNAME</username>
    <apiKey xsi:type="xsd:string">MY_API_ACCESS_KEY</apiKey>
</authenticate>

mentre la controparte XML-RPC ha questo aspetto:

<struct>
    <member>
        <name>authenticate</name>
        <value>
            <struct>
                <member>
                    <name>username</name>
                    <value>
                        <string>MY_USERNAME</string>
                    </value>
                </member>
                <member>
                    <name>apiKey</name>
                    <value>
                        <string>MY_API_ACCESS_KEY</string>
                    </value>
                </member>
            </struct>
        </value>
    </member>
</struct>

Come generare la tua una chiave API

Esistono due modi per generare una chiave di accesso API, attraverso il portale o attraverso chiamate API dirette. Per generare la propria chiave di accesso API nel portale del cliente:

  1. Accedere al [https://manage.softlayer.com/ portale del cliente SoftLayer] con il nome utente dell'utente principale del proprio account cliente e inserendo la password del portale.
  2. Fare clic sui link Amministrativo e Accesso API.
  3. Selezionare l'utente per cui si desidera generare una chiave e fare clic su Genera chiave di accesso API

Per generare una chiave di accesso API mediante chiamate API, richiamare il metodo addApiAuthenticationKey nel servizio SoftLayer_User_Customer. Per rimuovere una chiave di accesso API dell'utente, eseguire il metodo removeApiAuthenticationKey nel medesimo servizio. Prestare attenzione durante la rimozione delle chiavi di accesso API. La rimozione di queste chiavi comporta la rimozione della capacità dell'utente di utilizzare l'API SoftLayer.

Chiave API temporanea

È possibile ottenere un chiave API di breve durata utilizzando una combinazione di nome utente/password con SoftLayer_User_Customer::getPortalLoginToken. È possibile utilizzare questo token al posto di una chiave API durante le chiamate e scadrà dopo 48 ore.

Metodi associati

Consultare anche

Link esterni