Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

En esta página

Descripción
Depuración
Prototipo
Parámetros de solicitud
Códigos de estado
Parámetros de respuesta
Solicitud de ejemplo
Ejemplo de respuesta
Códigos de error
Ejemplo de comando cURL

Mostrar todo

Centro de ayuda/ Meeting/ Referencia de la API del servidor/ Autenticación del inicio de sesión/ APIs/ Realización de autenticación de proxy

Realización de autenticación de proxy

Actualización más reciente 2023-01-31 GMT+08:00

Ver PDF

Descripción

Esta API se utiliza para autenticar una cuenta proxy de terceros. Después de que la autenticación es exitosa, se genera un token de acceso. Actualmente, se admiten las siguientes cuentas proxy de terceros:

Cuentas y contraseñas de WeLink
Cuentas de terceros que cumplen con OAuth 2.0

SLA

Tasa de éxito de solicitudes: > 99.99%

Retraso de solicitud TP99: 40 ms

NOTA:

Cuando clientType se establece en 72 se pueden crear hasta 64 tokens para cada cuenta. Si se han creado 64 tokens usando una cuenta y los tokens son válidos, crear un nuevo token usando la misma cuenta invalidará el primer token entre los primeros 64 tokens.
Cuando clientType no se establece en 72 solo se puede crear un token para cada cuenta.
Un token es válido durante 12 a 24 horas.

Depuración

Puede depurar esta API en Explorador de API.

Prototipo

**Tabla 1** Prototipo
Método de solicitud	POST
Dirección de solicitud	/v1/usg/acs/auth/proxy
Protocolo de transporte	HTTPS

Parámetros de solicitud

**Tabla 2** Parámetros
Parámetro	Obligatorio	Tipo	Localización	Descripción
Content-Type	Sí	String	Header	Formato de medios del cuerpo, por ejemplo, application/json; charset=UTF-8.
X-Request-ID	No	String	Header	ID de solicitud, que se utiliza para el seguimiento y la localización de fallos. Se recomienda utilizar un UUID. Si este parámetro no se incluye, se genera automáticamente un ID de solicitud.
Accept-Language	No	String	Header	Idioma. Valores zh-CN para el chino (predeterminado) y en-US para el inglés.
account	No	String	Body	Cuenta de autenticación. maxLength: 255 minLength: 0
authServerType	Sí	String	Body	Tipo de servicio de autenticación. workplace: Autenticación de proxy de WeLink. oauth2: Autenticación de OAuth 2.0.
authType	Sí	String	Body	Modo de autenticación. AccountAndPwd: Autenticación de proxy de WeLink. AuthCode: Autenticación de OAuth 2.0
clientType	Sí	Integer	Body	Tipo de cuenta utilizada para iniciar sesión. 72: llamada a la API.
createTokenType	No	Integer	Body	Si se genera un token. 0: Se genera un token para la autenticación de inicio de sesión. 1 no se genera ningún token. Valor predeterminado: 0.
credential	No	String	Body	Si se utiliza OAuth 2.0, establezca este parámetro en el código temporal obtenido del centro de autenticación.
domain	No	String	Body	Nombre de dominio de empresa. Este parámetro es obligatorio para la autenticación de OAuth 2.0.
pwd	No	String	Body	Contraseña de autenticación. Este parámetro es obligatorio para la autenticación de proxy de WeLink. maxLength: 255 minLength: 0
remark	No	String	Body	Observaciones.

Códigos de estado

**Tabla 3** Códigos de estado
Código de estado de HTTP	Descripción
200	Operación exitosa.
400	Parámetros no válidos
401	Acceso denegado.
403	Permisos insuficientes.
412	La cuenta se deshabilitó.
423	La cuenta se ha bloqueado.
500	Excepción del servidor.

Parámetros de respuesta

**Tabla 4** Parámetros de respuesta
Parámetro	Tipo	Descripción
accessToken	String	Token de acceso.
clientType	Integer	Tipo de cuenta utilizada para iniciar sesión. 72: llamada a la API.
createTime	Long	Marca de tiempo cuando se crea el token, en milisegundos.
daysPwdAvailable	Integer	Período de validez de la contraseña.
delayDelete	Boolean	Si se retrasa la eliminación del token.
expireTime	Long	Marca de tiempo cuando el token caduca, en segundos.
firstLogin	Boolean	Si el inicio de sesión es el primer inicio de sesión. NOTA: Si inicia sesión en el sistema por primera vez, el sistema le pedirá que cambie la contraseña inicial. Valor predeterminado: false.
forceLoginInd	Integer	Si el inicio de sesión apropiativo está habilitado. 0: Deshabilitado. 1: Habilitado. (Este valor no se proporciona.)
proxyToken	ProxyTokenDTO object	Información de autenticación de proxy.
pwdExpired	Boolean	Si la contraseña ha caducado. Valor predeterminado: false.
refreshCreateTime	Long	Marca de tiempo cuando se crea un token de actualización, en milisegundos.
refreshExpireTime	Long	Marca de tiempo cuando el token de actualización expira, en segundos.
refreshToken	String	Actualice el token.
refreshValidPeriod	Long	Período de validez del token de actualización, en segundos.
tokenIp	String	Dirección IP del usuario.
tokenType	Integer	Tipo de token. 0: token de acceso de usuario. 1: token de control de reunión. 2: one-off token.
user	UserInfo object	Detalles de autenticación de usuario.
validPeriod	Long	Período de validez del token, en segundos.

Solicitud de ejemplo

POST /v1/usg/acs/auth/proxy
Connection: keep-alive
Content-Type: application/json
X-Request-ID: 5162fa32dc7e47afafeee39a72a2eec3
Accept-Language: zh-CN
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
    "clientType": "72",
    "authServerType": "workplace",
    "authType": "AccountAndPwd",
    "pwd": "1qaz@WSX",
    "createTokenType": 0,
    "account": "zhangsan@cloudlinkwp"
}

Ejemplo de respuesta

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 745
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
X-XSS-Protection: 1; mode=block
X-Download-Options: noopen
X-Content-Type-Options: nosniff
strict-transport-security: max-age=16070400; includeSubDomains
X-Frame-Options: SAMEORIGIN
Content-Security-Policy: default-src 'self' 'unsafe-inline' 'unsafe-eval' blob: data: http: https: ; child-src * ; connect-src *
x-request-id: 5162fa32dc7e47afafeee39a72a2eec3
Server: CloudPortal

{
    "accessToken": "stbNxmD2UXEDkHQD73sqMhXB6eXw6ngvSbo9",
    "clientType": 0,
    "createTime": 1599102826754,
    "daysPwdAvailable": -18172,
    "delayDelete": false,
    "expireTime": 1577979513,
    "firstLogin": true,
    "forceLoginInd": null,
    "proxyToken": null,
    "pwdExpired": false,
    "refreshCreateTime": 1599102826754,
    "refreshExpireTime": 1601694826,
    "refreshToken": "stbYaza5VVRr3IGuLSs6ZvF0lMHHvGO0tQ0f",
    "refreshValidPeriod": 2592000,
    "tokenIp": "10.8.0.90",
    "tokenType": 0,
    "user": {
        "adminType": 2,
        "alias1": null,
        "appId": null,
        "cloudUserId": "76aaaba8a12f4c0a8a43192...",
        "companyDomain": null,
        "companyId": "f5968fc4f9c14d50905e8e66672dabc6",
        "corpType": 0,
        "freeUser": false,
        "grayUser": false,
        "headPictureUrl": null,
        "isBindPhone": null,
        "name": "xxxx_name",
        "nameEn": null,
        "numberHA1": "1ead5e5ce44849bc2718d5c....",
        "paidAccount": null,
        "paidPassword": null,
        "password": null,
        "realm": "huaweicloud.com",
        "serviceAccount": "sip:xxxx@huaweicloud.com",
        "spId": "666bd8558e4646e1a7e1a0c99cf898e8",
        "status": 0,
        "thirdAccount": "62fe180o133fd...",
        "tr069Account": "X3M537A6IX4SC...",
        "ucloginAccount": "z8b2vo875ioh54r29ad5e3552vb3gm8np2j167...",
        "userId": "0d5202707123429d876....",
        "userType": 2,
        "visionAccount": null,
        "weLinkUser": false
    },
    "validPeriod": 84616
}

Códigos de error

Si se devuelve un código de error que comienza con MMC o USG cuando utiliza esta API, corrija el error siguiendo las instrucciones proporcionadas en el Centro de errores de la API de Huawei Cloud.

Ejemplo de comando cURL

curl -k -i -H 'content-type: application/json' -X POST  -H 'X-Request-ID: 5162fa32dc7e47afafeee39a72a2eec3,Content-Type: application/json,Accept-Language: zh-CN' -H 'date: 20190329T074551Z' -d '{"clientType":0,"authServerType":"workplace","authType":"AccountAndPwd","pwd":"1qaz@WSX","createTokenType":0,"account":"zhangsan@cloudlinkwp"}'
'https://api.meeting.huaweicloud.com/v1/usg/acs/auth/proxy'

Tema principal: APIs

Tema anterior: Cierre de sesión

Tema siguiente: Obtención de un nonce para redireccionamiento sin inicio de sesión

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar