Propiedades específicas de las variables de tipo OAuth2Parameters

Nombre de la propiedad	Tipo utilizado	Efecto
AdditionalParameters	Character string	Parámetros de la primera solicitud de autenticación. Esta cadena debe tener el mismo formato que los parámetros de URL.
AuthURL	Character string	URL de autorización a utilizar (primera URL del estándar OAuth 2.0).
ClientID	Character string	Identificador del cliente proporcionado por el servicio al registrar la aplicación.
ClientSecret	Character string	Código de acceso secreto de la aplicación. Este código lo proporciona el servicio al registrar la aplicación.
GrantType	Constant	Tipo de autorización disponible. Los valores posibles son: gtClientCredentials: Autenticación sin ventana de inicio de sesión. La autorización de acceso se otorga a la aplicación (no al usuario). El token proporcionado para acceder a los recursos de la aplicación está asociado a la aplicación. gtAuthorizationCode (Valor predeterminado): La autorización de acceso se concede al usuario. Una ventana de inicio de sesión permite que los usuarios introduzcan su nombre de usuario y contraseña. El token de acceso está asociado al usuario.
Option	Constante de tipo Integer	Opciones de autenticación: authDefault: Autenticación OAuth predeterminada. authPKCE: Autenticación con PKCE (Clave de prueba para el intercambio de códigos). Observación: PKCE proporciona seguridad adicional en comparación con OAuth. En algunos casos, aunque se utilice el protocolo PKCE, puede ser necesario especificar la clave secreta (propiedad ClientSecret). Le recomendamos que verifique la información esperada por la plataforma utilizada.
RedirectionURL	Character string	URL de redirección a utilizar durante el mecanismo de autenticación. Para una aplicación Windows o Android, esta URL debe tener el siguiente formato: "http://localhost:PortNumber". Este valor debe ser exactamente el mismo que se especificó al declarar la aplicación en el servicio web correspondiente. Esta propiedad debe especificarse. Corresponde al esquema de URL de redireccionamiento especificado por el proveedor del servicio web para iOS. Ejemplos: para Facebook, la URL debe tener el siguiente formato: "fb<ClientID>://authorize/". para Google, la URL debe tener el siguiente formato: "<Esquema de URL de iOS>:/oauth2redirect", donde: <Esquema de URL de iOS> corresponde al valor proporcionado por Google al crear un ID de cliente OAuth para iOS. "/oauth2redirect" es un ejemplo de valor. Este parámetro puede ser cualquier valor que empiece por una sola barra inclinada "/" (por ejemplo, no se admite "//oauth2redirect").
ResponseType	Cadena de caracteres o constante	Tipo de respuesta esperada. Los valores posibles son: oauth2ResponseTypeCode (o "Code"): La respuesta es de tipo "Code". oauth2ResponseTypeToken (o "Token"): La respuesta es de tipo "Token". El valor predeterminado es oauth2ResponseTypeCode. Observaciones: Para una autenticación "personal", el tipo de respuesta debe ser "Token". En el caso de una autenticación para una API o un servicio (por ejemplo, el servidor de correo de Google), el tipo de respuesta debe ser "Code".
Scope	Character string	Permisos solicitados. Los valores posibles son específicos del servicio web utilizado. Los valores posibles deben estar separados por un espacio.
TokenURL	Character string	URL para obtener el token de acceso a utilizar (segunda URL del estándar OAuth 2.0).

Cómo funciona la autenticación OAuth 2.0

• Ejecución de una primera solicitud HTTP para pedir una autorización (URL de autorización especificada en la variable de tipo OAuth2Parameters).
• Apertura de una ventana de autenticación OAuth 2.0. La ventana de autenticación la define cada servicio.
• Tras la autenticación, el servidor devuelve un código de autorización para solicitar un token de acceso. Este código se añade en el parámetro de la segunda URL (URL del token de acceso especificado en la variable de tipo OAuth2Parameters).
• Ejecución de una segunda solicitud HTTP para obtener el token de acceso. El resultado es un buffer JSON que contiene, entre otros elementos, el token de acceso ("access_token") que se utilizará para las solicitudes que requieran autenticación. La variable de tipo AuthToken contiene la información que se encuentra en el buffer JSON. Este token de acceso será utilizado por las llamadas a las API del servicio web.

• Si el servidor no devuelve el token de acceso en formato de código JSON según el estándar OAuth2.0, se producirá un error y no se recibirá el token. La respuesta del servidor se puede obtener mediante la propiedad ServerResponse de la variable de tipo AuthToken.
• Si el servidor no soporta el encabezado HTTP "Authorization" para transmitir el token de acceso, el desarrollador debe realizar la transmisión según el formato esperado por el servicio solicitado.
  El siguiente ejemplo permite utilizar el servicio Web de Facebook. En este caso, el token de acceso debe especificarse en la URL de la solicitud.
  • Ejemplo de código para Facebook
    

    // Exemple permettant de récupérer le nom du compte Facebook
    MonToken is AuthToken
    MonTokenParam is OAuth2Parameters
    
    MonTokenParam.ClientID = "123456789012345"
    MonTokenParam.ClientSecret = "45g8jh5kll45579021qsg5444j"
    MonTokenParam.AuthURL = "https://www.facebook.com/dialog/oauth"
    MonTokenParam.TokenURL = "https://graph.facebook.com/v2.3/oauth/access_token"
    MonTokenParam.RedirectionURL = "http://localhost:9874/"
    MonTokenParam.Scope = "email"
    
    MonToken = AuthIdentify(MonTokenParam)
    IF MonToken <> Null THEN
    	IF ErrorOccurred THEN
    		Error(ErrorInfo())
    	ELSE
    		// Token précisé sur l'URL de la requête
    		HTTPRequest("https://graph.facebook.com/me?access_token=" + MonToken.Value)
    		vMonRes is Variant = JSONToVariant(HTTPGetResult(httpResult))
    		// Récupération du nom du compte
    		Trace(vMonRes.name)
    	END
    END

  • Ejemplo de código para Facebook:
    

    MonToken is AuthToken
    MonTokenParam is OAuth2Parameters
    MonTokenParam.ClientID = "1705548803004741"
    MonTokenParam.ClientSecret = "7b3305a5aa1687ef04af001ec3388ecc"
    MonTokenParam.AuthURL = "https://www.facebook.com/dialog/oauth"
    MonTokenParam.TokenURL = "https://graph.facebook.com/oauth/access_token"
    MonTokenParam.RedirectionURL = "fb1705548803004741://authorize/"
    MonTokenParam.Scope = "email"
    
    MonToken = AuthIdentify(MonTokenParam)
    IF MonToken <> Null THEN
    	IF ErrorOccurred THEN
    		Error(ErrorInfo())
    	ELSE
    		// Token précisé sur l'URL de la requête
    		HTTPRequest("https://graph.facebook.com/me?access_token=" + MonToken.Value)
    		vMonRes is Variant = JSONToVariant(HTTPGetResult(httpResult))
    		// Récupération du nom du compte
    		Trace(vMonRes.name)
    	END
    END