Autenticación en la API de SoftLayer

username, que contiene el nombre de usuario del portal/API, y apiKey, que contiene la clave de acceso de API. Si no proporciona la cabecera de autenticación, la API devuelve la excepción "No se han encontrado cabeceras de autenticación válidas" y, si proporciona una combinación de username y apiKey no válida, la API devuelve la excepción "Señal de API no válida".

Una representación de SOAP de la cabecera authenticate será como la siguiente:

<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>

mientras que su contrapartida de XML-RPC será como la siguiente:

<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>

Generación de la clave de API

Hay dos formas de generar una clave de acceso de API: utilizando el portal o con llamadas de API directas. Para generar su propia clave de acceso de API en el portal de clientes:

  1. Inicie una sesión en el [https://manage.softlayer.com/ portal de clientes de SoftLayer] con el nombre de usuario y la contraseña de portal del usuario maestro de la cuenta de cliente.
  2. Pulse los enlaces administrativo y Acceso de API.
  3. Seleccione el usuario para el que desee generar una clave y pulse Generar clave de acceso de API

Para generar una clave de acceso de API utilizando las llamadas de API, invoque el método addApiAuthenticationKey en el servicio SoftLayer_User_Customer. Para eliminar la clave de acceso de API de un usuario, ejecute el método removeApiAuthenticationKey en el mismo servicio. Tenga cuidado cuando elimine claves de acceso de API. La eliminación de estas claves eliminará la capacidad del usuario de utilizar la API de SoftLayer.

Clave de API temporal

Se puede obtener una clave efímera de API mediante una combinación de nombre de usuario/contraseña con SoftLayer_User_Customer::getPortalLoginToken. Esta señal se puede utilizar durante las llamadas en lugar de la clave de API y caduca pasadas 48 horas.

Métodos asociados

Véase también

Enlaces externos