Propiedades específicas de la descripción de las variables OAuth2Parameters

Nombre de la propiedad	Tipo utilizado	Efecto
AdditionalParameters	Cadena de caracteres	Parámetros de la primera consulta de autenticación. Esta cadena debe estar formateada como los parámetros de la URL.
AuthURL	Cadena de caracteres	URL de autorización a utilizar (primera URL del estándar OAuth 2.0).
campo de aplicación	Cadena de caracteres	Permisos solicitados. Los posibles valores son específicos del servicio web utilizado.
ClientID	Cadena de caracteres	Identificador del cliente proporcionado por el servicio al registrar la aplicación.
ClientSecret	Cadena de caracteres	Código de acceso secreto de la aplicación. Este código viene dado por el servicio al guardar la aplicación.
RedirectionURL	Cadena de caracteres	URL de redirección a utilizar durante el mecanismo de autenticación. Para una aplicación de Windows o Android, esta URL debe tener el siguiente formato "http://localhost:PortNumber". Este valor debe ser estrictamente idéntico al especificado al declarar la aplicación en el servicio web correspondiente. Esta Property debe ser necesariamente llenada. Corresponde al esquema de URL de redirección 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 "<ID del grupo>:/oauth2redirect". Para un sitio WEBDEV, esta URL se calcula automáticamente. Por lo tanto, no hay necesidad de asignar la Property. Esta URL debe especificarse en la configuración de la aplicación del proveedor de servicios de autenticación.. Tiene el siguiente formato: " http(s)://localhost/WD27 0AWP/WD27 0Awp.exe/ OAUTH2_RETURN". El HTTPS se utilizará automáticamente si es necesario en la URL de redirección. Si un proxy HTTP actúa como intermediario entre el WEBDEV servidor de aplicaciones que aloja el sitio y el servidor de autenticación, el proxy debe estar configurado para indicar el protocolo correcto en el entorno HTTP "Reenviado" Variable.
Versiones 25 y posteriores Tipo de respuesta Nueva funcionalidad versión 25 Tipo de respuesta Tipo de respuesta	Cadena de caracteres o constante	Tipo de respuesta esperada. Los valores posibles son: oauth2ResponseTypeCode (o "Código"): La respuesta es de tipo "Código". oauth2ResponseTypeToken (o "Token"): La respuesta es del tipo "Token". oauth2ResponseTypeToken es el valor de Default. Observación: Para una autentificación "personal", el tipo de respuesta debe ser "Token". En el caso de una autenticación para un API o servicio (por ejemplo, el servidor de correo de Google), el tipo de respuesta debe ser "Código".
TokenURL	Cadena de caracteres	URL para obtener el token de acceso a utilizar (segunda URL del estándar OAuth 2.0).

Modo de funcionamiento de 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 identificación de usuarios según el protocolo OAuth 2.0. La interfaz de identificación corresponde al servicio al que se accede.
• Después de la identificación, el servidor devuelve un primer código de autorización que permite solicitar un token de acceso a los recursos. 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 la segunda solicitud HTTP para solicitar el token de acceso. El resultado es un buffer JSON que contiene, entre otras cosas, el token de acceso ("access_token") que se utilizará para las solicitudes autenticadas. 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 obtendrá el token. La respuesta del servidor puede recuperarse a través del ServerResponse Property del AuthToken Variable.
• 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
    
    // Example used to retrieve the name of the Facebook account
    MyToken is AuthToken
    MyTokenParam is OAuth2Parameters
     
    MyTokenParam.ClientID = "123456789012345"
    MyTokenParam.ClientSecret = "45g8jh5kll45579021qsg5444j"
    MyTokenParam.AuthURL = "https://www.facebook.com/dialog/oauth"
    MyTokenParam.TokenURL = "https://graph.facebook.com/v2.3/oauth/access_token"
    MyTokenParam.RedirectionURL = "http://localhost:9874/"
    MyTokenParam.Scope = "email"
     
    MyToken = AuthIdentify(MyTokenParam)
    IF MyToken <> Null THEN
    IF ErrorOccurred THEN
    Error(ErrorInfo())
    ELSE
    // Token specified on the request URL
    HTTPRequest("https://graph.facebook.com/me?access_token=" + MyToken.Value)
    vMyRes is Variant = JSONToVariant(HTTPGetResult(httpResult))
    // Retrieve the account name
    Trace(vMyRes.name)
    END
    END
    
  • Ejemplo de código para Facebook:
    
    MyToken is AuthToken
    MyTokenParam is OAuth2Parameters
    MyTokenParam.ClientID = "1705548803004741"
    MyTokenParam.ClientSecret = "7b3305a5aa1687ef04af001ec3388ecc"
    MyTokenParam.AuthURL = "https://www.facebook.com/dialog/oauth"
    MyTokenParam.TokenURL = "https://graph.facebook.com/oauth/access_token"
    MyTokenParam.RedirectionURL = "fb1705548803004741://authorize/"
    MyTokenParam.Scope = "email"
     
    MyToken = AuthIdentify(MyTokenParam)
    IF MyToken <> Null THEN
    IF ErrorOccurred THEN
    Error(ErrorInfo())
    ELSE
    // Token specified on the request URL
    HTTPRequest("https://graph.facebook.com/me?access_token=" + MyToken.Value)
    vMyRes is Variant = JSONToVariant(HTTPGetResult(httpResult))
    // Retrieve the account name
    Trace(vMyRes.name)
    END
    END