x

Estas etiquetas son obligatorias.

<?xml version="1.0" encoding="utf-8"?> 
<authentications>

x

Esta etiqueta es obligatoria.

<authentication name="form1" [desc="Description of Form 1"]>

donde:

form1

Es un nombre para la plantilla.

Description of Form 1

Es el nombre mostrado en la lista Autenticación de componentes Web. Si el atributo está omitido, aparece el valor del atributo de name.

x

Estas etiquetas son obligatorias.

<sso_logon_resource desc="Logon Resource" [read_only="{true|false}"] 
[visible="{true|false}"]>
  <protocol [default="{protocol|https|%%environment%%}"] /> 
  <host [default="{hostname|%%environment%%}"] /> 
  <port [default="{port_number|%%environment%%}"] /> 
  <path default="resource_uri" /> 
</sso_logon_resource>

donde:

sso_logon_resource

Es el URL del programa que conectará a los usuarios con el producto SSO. Por ejemplo, este programa puede ser un jsp, miniservidor, página de servidor activo o un CGI.

Logon Resource

Es la descripción mostrada en la lista Autenticación de componentes Web.

read_only="{true|false}"

'Verdadero' especifica que el valor puede cambiarse en la ventana Entornos de Developer Studio, mientras que 'falso' indica lo contrario. El valor predeterminado verdadero.

visible="{true|false}"

'Verdadero' especifica que el valor puede verse en la ventana Entornos de Developer Studio, mientras que 'falso' indica lo contrario. El valor predeterminado verdadero.

protocol

Es el protocolo usado para llegar al recurso de inicio de sesión; puede ser http o https.

hostname

Es el nombre de host del recurso de inicio de sesión.

port_number

Es el número de puerto del recurso de inicio de sesión. Si el atributo predeterminado no está especificado, no se emplea ningún valor puerto explícito en la conexión. En este caso, el puerto efectivo depende del valor de protocolo. Si el protocolo es http, el puerto es el 80. Si el protocolo es https, el puerto es el 443. Si el valor no empieza por una barra (/), se agrega una como prefijo al valor de la palabra clave predeterminada.

%%environment%%

Es una variable de plantilla que queda remplazada en tiempo de ejecución por el valor correspondiente, situado en el cuadro de diálogo Entorno de componentes Web.

resource_uri

Es la parte del URL posterior al puerto; especifica la ruta del recurso de inicio de sesión.

x

Estas etiquetas son obligatorias.

Si el inicio de sesión es correcto, el resultado es una cookie. Si el inicio de sesión es incorrecto, el sistema de seguridad no devuelve una cookie, indicando a Developer Studio que el inicio de sesión ha fallado. En este caso, Developer Studio abre un cuadro de diálogo de inicio de sesión que permite que el usuario vuelva a introducir el Id. y la contraseña.

Si se devuelve una cookie, Developer Studio considera que el inicio de sesión ha sido correcto y reenvía la cookie a WebFOCUS en cada solicitud. Para describir la cookie necesaria para la autenticación, añada las etiquetas siguientes a la plantilla:

<logon_result name="cookie_name" [type="cookie"]  [visible="false"] />

donde:

cookie_name

Es el nombre de la cookie devuelta por el recurso de incio de sesión. Este nombre distingue el uso de mayúsculas y minúsculas.

type=cookie

Indica que Developer Studio está esperando que el inicio de sesión sea correcto. Si se encuentra omitido, el valor predeterminado es cookie.

visible="{true|false}"

'Verdadero' especifica que el valor puede verse en la ventana Entornos de Developer Studio, mientras que 'falso' indica lo contrario. El valor predeterminado es falso.

x

Estas etiquetas son obligatorias.

<user name="user" [desc="user ID"] [default="%%environment%%"] 
[read_only="true"] [visible="true|false"] /> 
<password name="password" [desc="Password"] [default="%%environment%%"]
[read_only="true"] [visible="{true|false}"] /> 

donde:

usuario

Es el Id. de usuario autenticado. Tenga en cuenta que este valor se encuentra establecido como de sólo lectura y se obtiene por defecto, desde el cuadro de diálogo Entorno de componentes Web.

Id. de usuario de

Es el nombre mostrado en la lista Autenticación de componentes Web. Si el atributo está omitido, aparece el valor del atributo de user name.

%%environment%%

Es una variable de plantilla que queda remplazada en tiempo de ejecución por el valor correspondiente, situado en el cuadro de diálogo Entorno de componentes Web.

read_only="{true|false}"

'Verdadero' especifica que el valor puede cambiarse en la ventana Entornos de Developer Studio, mientras que 'falso' indica lo contrario. El valor predeterminado verdadero.

visible="{true|false}"

'Verdadero' especifica que el valor puede verse en la ventana Entornos de Developer Studio, mientras que 'falso' indica lo contrario. El valor predeterminado verdadero.

password

Es la contraseña autenticada. Tenga en cuenta que este valor se encuentra establecido como de sólo lectura y se obtiene por defecto, desde el cuadro de diálogo Entorno de componentes Web. El valor no aparece, incluso si se ha especificado la propiedad visible.

Contraseña

Es el nombre mostrado en la lista Autenticación de componentes Web. Si el atributo está omitido, aparece el valor del atributo de password name.

x

La necesidad de variables adicionales se determina en función de lo que necesite para procesar un inicio de sesión (aparte de un Id. de usuario y una contraseña).

<variable name="var1" [desc="Label 1"] [default="initial_value"] 
  [read_only="{true|false}"] [visible="{true|false}"] 
  [optional="{true|false}"] 
  [<protocol [default="{protocol|http|%%environment%%}"] [visible="false"] />]
  [<host [default="{hostname|%%environment%%}"] [visible="false"] />]
  [<port [default="{port_number|80|%%environment%%}"] [visible="false"] />]
  [<path default="resource_uri" [visible="false"] />]
</variable>

donde:

var1

Es un nombre para la variable adicional, requerida por el sistema de seguridad.

Label 1

Es el nombre mostrado en la lista Autenticación de componentes Web. Si el atributo está omitido, aparece el valor del atributo de variable name.

initial_value

Es un valor predeterminado para la variable.

read_only="{true|false}"

Cuando es verdadero indica que el valor puede cambiarse en la ventana Entornos de Developer Studio, mientras que falso señala lo contrario. Falso especifica que el valor no puede ser modificado. El valor predeterminado es falso.

visible="{true|false}"

'Verdadero' especifica que el valor puede verse en la ventana Entornos de Developer Studio, mientras que 'falso' indica lo contrario. El valor predeterminado es verdadero para la etiqueta de nombre de la variable y falso, para las etiquetas de protocolo, host, puerto y ruta.

optional="{true|false}"

'Verdadero' especifica que el atributo es opcional, mientras que falso indica que no. El valor predeterminado es falso.

protocol

Se utiliza para especificar el protocolo, si el producto SSO necesita información para la variable adicional. Para verlo en contexto, consulte la descripción de la etiqueta sso_logon_resource.

hostname

Se utiliza para especificar el nombre de host, si el producto SSO necesita información para la variable adicional. Para verlo en contexto, consulte la descripción de la etiqueta sso_logon_resource.

port_number

Se utiliza para especificar el número de puerto, si el producto SSO necesita información para la variable adicional. Para verlo en contexto, consulte la descripción de la etiqueta sso_logon_resource.

%%environment%%

Es una variable de plantilla que queda remplazada en tiempo de ejecución por el valor correspondiente, situado en el cuadro de diálogo Entorno de componentes Web.

resource_uri

Se utiliza para especificar el URL del recurso, si el producto SSO necesita información para la variable adicional. Para verlo en contexto, consulte la descripción de la etiqueta sso_logon_resource.

x

Developer Studio borra la información de la cookie por defecto, cuando el usuario sale o cierra la sesión. Para retener las cookies especificadas por el usuario, sus nombres deben añadirse por medio de una lista de excepción de cookie, en el archivo de plantillas. Puede añadir esta lista a una plantilla existente o puede crear una nueva para guardar sólo la lista de cookies. El número de cookies que se pueden especificar no está limitado.

<cookie_exclude_list>
  <variable name="var1" default="cookie_name" visible="true"/>
</cookie_exclude_list>

var1

Es el nombre de un parámetro para la cookie.

cookie_name

Es el nombre de la cookie. Si el valor está en blanco o contiene un nombre de ejemplo para fines de visualización, el desarrollador debe especificar el nombre de cookie obligatorio, en el cuadro de diálogo Ajustes de autenticación.

visible="{true|false}”

'Verdadero' especifica que el valor puede verse en la ventana Entornos de Developer Studio, mientras que 'falso' indica lo contrario. El valor predeterminado verdadero.

x

Esta etiqueta es obligatoria.

</authentication>

x

Esta etiqueta es obligatoria.

</authentications>

Principio de página

Ejemplo: Archivo de plantillas de ejemplo

Developer Studio incluye varias plantillas de ejemplo en el archivo. El ejemplo siguiente muestra la plantilla de inicio de sesión de SiteMinder. Tenga en cuenta que:

• El nombre del recurso de inicio de sesión es ibi_sm. La descripción aparece en el cuadro de diálogo Autenticación de componentes Web es SiteMinder.
• La información del URL proviene del cuadro de diálogo Componente Web. El URL es /siteminderagent/forms/login.fcc.
• El resultado del inicio de sesión es una cookie llamada SMSESSION. Hay dos variables obligatorias, SMAUTHREASON y TARGET. TARGET proporciona información sobre el URL de la página principal de WebFOCUS.

<authentication name="ibi_sm" desc="SiteMinder">
  <sso_logon_resource desc="Logon Resource" read_only="false" visible="false">
    <protocol default="%%environment%%" /> 
    <host default="%%environment%%" /> 
    <port default="%%environment%%" /> 
    <path desc="" default="/siteminderagent/forms/login.fcc" /> 
  </sso_logon_resource>
  <user name="user" desc="User Id" default="%%environment%%" 
     read_only="true" visible="true" /> 
  <password name="password" desc="Password" default="%%environment%%" 
     read_only="true" visible="true" /> 
  <logon_result name="SMSESSION" type="cookie" /> 
  <variable name="SMAUTHREASON" default="0" read_only="true" 
     visible="true" /> 
  <variable name="TARGET" read_only="false" visible="true">
   <protocol default="%%environment%%" /> 
   <host default="%%environment%%" /> 
   <port default="%%environment%%" /> 
   <path default="/ibi_html/index.html" /> 
  </variable>
 </authentication>

Se abre el cuadro de diálogo Ajustes de autenticación, como indica la siguiente imagen.

Principio de página

Ejemplo: Plantilla de ejemplo con una lista de exclusión de cookies

El ejemplo siguiente muestra una plantilla de SiteMinder con una lista de excepciones de cookies.

<authentication name="ibi_sm" desc="SiteMinder">
   <sso_logon_resource desc="Logon Resource" read_only="false" visible="false">
     <protocol default="%%environment%%"/>
     <host default="%%environment%%"/>
     <port default="%%environment%%"/>
     <path desc=""default="/siteminderagent/forms/login.fcc"/>
   </sso_logon_resource>
   <user name="user" desc="User Id" default="%%environment%%" 
    read_only="true" visible="true"/>
   <password name="password" desc="Password"default="%%environment%%"
    read_only="true" visible="true"/>
   <logon_result name="SMSESSION" type="cookie"/>
   <variable name="SMAUTHREASON" default="0"read_only="true" visible="true"/>
   <variable name="TARGET" read_only="false"visible="true">
     <protocol default="%%environment%%"/>
     <host default="%%environment%%"/>
     <port default="%%environment%%"/>
     <path default="/ibi_html/index.html"/>
   </variable>
   <cookie_exclude_list>
     <variable name="ExcludeCookie1" visible="true">CookieName1</variable>
     <variable name="ExcludeCookie2" visible="true">CookieName2</variable>
     <variable name="ExcludeCookie3" visible="true">CookieName3</variable>
   </cookie_exclude_list>
</authentication>

El cuadro de diálogo Ajustes de autenticación aparece cuando SiteMinder se ha seleccionado como el componente de autenticación Web en el cuadro de diálogo Propiedades de entorno de WebFOCUS, como indica la siguiente imagen.

Principio de página

Ejemplo: Plantilla de ejemplo con una lista de cookies excluidas y ninguna solicitud de inicio de sesión

En el ejemplo siguiente aparece una plantilla denominada Cookie_save_list, en la que la solicitud de inicio de sesión se ha desactivado estableciendo el parámetro sso_logon_resource en NONE.

<authentication name="ibi_Preserve_Cookies_Template"
      desc="Cookie_save_list">
  <sso_logon_resource desc="Logon Resource" read_only="false"
      visible="false">NONE  </sso_logon_resource>
  <user name="user" desc="User's Name" default="%%environment%%"
      read_only="true" visible="true"/>
  <password name="password" desc="User's Password"
      default="%%environment%%" read_only="true" visible="true" />

<cookie_exclude_list>
   <variable name="ExcludeCookie1" default="CookieName1"
       visible="true"/>
   <variable name="ExcludeCookie2" default="CookieName2"
       visible="true"/>
   <variable name="ExcludeCookie3" default="CookieName3"
       visible="true"/>
   <variable name="ExcludeCookie4" default="CookieName4"
       visible="true"/>
  </cookie_exclude_list>
</authentication>

Los resultados aparecen en el cuadro de diálogo Ajustes de autenticación, como se indica en la imagen siguiente.