---
title: Configurar Okta en 4biz
slug: es/configurar-okta-en-4biz
description: Learn how to set up Okta authentication for users in a 4biz instance with this comprehensive guide. Discover the step-by-step process for creating an Okta account, setting up the 4biz application within Okta, and assigning users to the application. Explor
createdAt: 2021-10-13T17:13:19.000Z
---

Este método de autenticación le permite utilizar los recursos de **Okta&#x20;**&#x70;ara autenticar a los usuarios de su organización en una instancia <font color="#ff6900">**4biz**</font>. Este documento explica los pasos para configurar este método. Para saber más sobre el Okta accede <font color="#2166ae"><u>**okta.com**</u></font>

## Antes de Empezar

- [x] La configuración de esta solución es un proceso de varias fases;
- [x] La primera fase es la creación de una cuenta de Okta.

## Procedimiento

******<font color="#2166ae"><u>***1º Paso***</u>***\:***</font>*&#x20;Crear una cuenta Okta:*

1. Acceda al sítio:  [https://www.okta.com](https://www.okta.com);
2. Haga clic en **"*Try Okta*"** y después en **"*Sign up today*"**;
3. Informe los datos esenciale (correo electrónico, nombre y apellido);&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/IlLKnnNuJ_ihn1d_cPBnW_6gqzewtxox430eaezwn1qimage.png" size="58" width="420" height="448" position="center" showCaption="false"}

4\. Haga clic e&#x6E;**&#x20;"*Get Started*"** para completar la operación. Después, compruebe el correo electrónico registrado (que enviará un enlace de acceso), acceda a la cuenta con la contraseña temporal enviada y la cambie para mayor seguridad de los datos;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/mUEAwRrTU_3vPv7JNoLgW_e-zlgm5wxrxunumob2hbimage.png)

<u>******</u><font color="#2166ae"><u>***2º Paso***</u></font>******<font color="#2166ae">***\:*** </font>*Crear la aplicación&#x20;*<font color="#ff6900">***4biz***</font>*&#x20;dentro del Okta:*

1. Después de completar el paso anterior, conectarse al Okta con su cuenta recién creada;
2. Haga clic en la pestaña **"*Applications*"** y luego en **"*Add Application*"**;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/2KZ-zs6MK4StwjLZofKEB_aorj7l1m2uxe4f5xa4nifimage.png)

3\. Haga clic en **"*Create New App*"**;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/dssvANZhZzVlnVThPuZtz_c2ovzu32afnrwppbzdbswimage.png)

4\. Marque la opción **"*SAML 2.0*"** y después haga clic en **"*Create*"**;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/mYbn22f7pNRPzcmfmPucI_wkclbsw4cmf2ofpictnp5image.png)

5\. En el campo **"*App Name*"**, añada el nombre de la aplicación y después, haga clic en **"*Next*"**;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/teIGHhfZRhjD_awqJ2pbs_cuimn4mh6lkorzyh7vk6dimage.png)

6\. Configure la ruta de la aplicación y luego haga clic en el botón **"*Next*"**;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Ro1DzUTXQ-Z3KTfAQBGwM_wgtgpytobjr7bwk00hl7pimage.png)

:::hint{type="warning"}
⚠ <u>**Atención**</u>**!**

En el campo **"Single sign on URL"** y **"Audience URI (SP Entity ID)"** se deben incluir las direcciones URL donde se ejecutará la aplicación <font color="#ff6900">**4biz**</font>.
:::

7\. Marcar las opcione&#x73;**&#x20;"*I'm an Okta customer adding an internal app*"** y **"*This is an internal app that we have created*"**. Después, haga clic en **"*Finish*"**.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/yRtJTijMv-xTsY85xADBs_agpzvisdkmxpo0emhelimage.png)

******<font color="#2166ae"><u>***3º Paso***</u>***\:***</font>*&#x20;Asignar usuarios a la aplicación&#x20;*<font color="#ff6900">***4biz***</font>*&#x20;del Okta:*

1. Concluido el paso anterior, es necesario hacer clic en la pestaña `Applications > Applications` y después en **"*Assign Applications*"** y optar por el filtro **"*People*"**;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/dqJq6t32QooUGaW5qRExY_z8975y2rmkjnacfrtwbgqimage.png)

2\. Después, se puede elegir el usuario que tendrá el permiso para acceder a la aplicación que se está creando. Haga clic en **"*Assign*"** y luego para finalizar, haga clic en **"*Done*"**;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/kdUS7KL6OaBtXyD_RxbDg_mcr5t5hc4we6obzehndrimage.png)

<u>******</u><font color="#2166ae"><u>***4º Paso***</u>***\:***</font> *Incluir la información necesaria en el&#x20;*<font color="#ff6900">***4biz***</font>*&#x20;configurado en el Okta:*

1. Es necesario configurar algunos datos en el directorio del WildFly. Acceda al directorio, abra la carpeta <font color="#2166ae">**"/standalone/configuration"**</font> y cambie el archivo "**4biz .cfg**".

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/kjzCM5r7PgPV9VbEVJmjh_kpjfucq5t9mhmrrqosnnimage.png)

2\. Accedendo al archivo, se debe incluir estas informaciones en el archivo "**4biz .cfg**"\::

a) En la línea ***SAML2\_HOST y SAML2\_PORT*** incluya la dirección y el puerto de la aplicación <font color="#ff6900">**4biz**</font>;&#x20;

b) En la línea ***SAML2\_METADATA*** incluya los metadatos Okta SAML. Estos datos se pueden obtener siguiendo las instrucciones:

- &#x20;Acceda a la aplicación <font color="#ff6900">**4biz**</font> en Okta, haga clic en la pestaña`Aplicaciones > Aplicaciones`y luego en la opción "**Iniciar sesión**". Al pulsar la opción "Metadatos del Proveedor de Identidad", se dispondrá de una nueva pestaña con los metadatos, copie la URL del navegador e insértela en la propiedad ***SAML2\_METADATA*** ;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/weGKpgvMd3pfy8AHu1Qcp_t8imy6jnnf8egadwxjvgvimage.png)

c) En la línea ***OKTA\_URL***, incluya la URL principal de la cuenta de Okta.&#x20;

d) En la línea ***OKTA\_TOKEN*** incluir el token para acceso vía API. Para obtener este token, siga estos pasos:&#x20;

- Acceda a la aplicación <font color="#ff6900">**4biz**</font> en Okta, seleccione la opción `Seguridad > API` en el menú y luego haga clic en el botón **"Crear token"**. Asigne un nombre al token y presione el botón **"Crear token"**. A continuación, se mostrará el valor del token, que debe copiarse en la línea mencionada anteriormente.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/KxxCQu0ZZpY_9x9xOIBgd_y63u5g6iebf60wdnszoyimage.png)

e) En la línea **OKTA\_DOMAIN\_ALIAS** incluir el dominio de los usuarios provenientes de Okta.&#x20;

<font color="#2166ae"><u>***5º***</u> </font><u>******</u><font color="#2166ae"><u>***Paso***</u>***\:***</font> Sincronice el usuario de Okta en <font color="#ff6900">***4biz***</font>:&#x20;

1. Dentro de <font color="#ff6900">***4biz***</font>, acceda al menú **"Okta Config"** y registre una nueva configuración haciendo clic en el botón **"Nuevo"**;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/NeW92CZwIuPK1Ti5GMKU7_3ttpeid0gghwmdvwfu-wimage.png)

2\. Complete los campos con la información necesaria:

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/3nwndFXge8tgC0fbWmtuk_zriay8j6hslg8yiphqdlximage.png)

- <u>**Descripción:**</u> introduce una definición de esta nueva configuración de Okta;
- <u>**Alias:**</u> incluir el dominio del usuario que quedará registrado en la base. Ejemplo: <font color="#2166ae"><u>**okta\\**</u></font><u>****</u>[administrator@run2biz.com](mailto\:administrator@run2biz.com);&#x20;
- <u>**URL del dominio:**</u> debe incluir el mismo valor (URL) que se ingresó en la línea OKTA\_URL en el archivo **"4biz .cfg"**;&#x20;
- <u>**Token API:&#x20;**</u>incluya el mismo valor de token ingresado en la línea OKTA\_TOKEN en el archivo **"4biz .cfg"**;
- <u>**Grupo:**</u> ingrese el ID del grupo al que pertenecerá el usuario sincronizado y registrado en <font color="#ff6900">**4biz**</font>;&#x20;
- <u>**Perfil de Acceso:**</u> ingrese el ID del perfil al que pertenecerá el usuario sincronizado y registrado en <font color="#ff6900">**4biz**</font>;&#x20;
- <u>**ID de la aplicación:**</u> incluya el ID de la aplicación. Esta información se puede recuperar de la URL de Okta, como se muestra en la siguiente imagen:

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/RqpOv6gbBe66j9qMh8eCS_vy4d6rtemg6x2wl6v3ogeimage.png)

3\. Haga clic en el botón **"Guardar"** y luego en **"Sincronizar usuarios"** para realizar la operación.

<u>******</u><font color="#2166ae"><u>***6º Paso***</u>***\:*** </font>*Configurar el cierre de sesión:*&#x20;

1. Como Okta no tiene una pantalla de cierre de sesión, en el **parámetro 377** de <font color="#ff6900">**4biz** </font>podemos insertar alguna dirección de página para redirigir al usuario al final de la sesión;
2. Configure el enlace de cierre de sesión también en la dirección`Administrador > Configuración > Personalización > Página de cierre de sesión`, luego marque la opción **"Usar página de cierre de sesión personalizada"**. Luego, ingrese la URL ([https://localhost:8443/4biz/saml/logout](https://localhost:8443/4biz/saml/logout)) con las adaptaciones correspondientes (host y puerto), como se muestra en la siguiente imagen:

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/3x2s5c7xroWXZsrX7iSPv_kfy5holvkhnmurbtngy9yimage.png)

:::hint{type="info"}
🖊 <u>**Nota**</u>**:&#x20;**&#x41;&#x6C;**&#x20;cerrar** sesión en <font color="#ff6900">**4biz**</font>, **no debe cerrar** sesión en Okta, ya que el usuario puede tener otras aplicaciones en la sesión de Okta. Por otro lado, si **cierra** la sesión de Okta, se **eliminará** la sesión <font color="#ff6900">**4biz**</font> del usuario.
:::

## ¿Que hacer después?

Una vez que se completa la integración de Okta con <font color="#ff6900">**4biz**</font>, se pueden configurar algunos parámetros de <font color="#ff6900">**4biz**</font> para personalizar mejor esta integración:&#x20;

- **El parámetro 445** (Nombre del grupo de administradores en Okta) permite elegir el grupo de administradores en la solución de Okta. Si el usuario pertenece a este grupo elegido, el perfil de acceso se establecerá como administrador. Si el usuario no tiene un perfil definido, el sistema le asignará el **parámetro 39** y si este usuario ya tiene un perfil definido en <font color="#ff6900">**4biz**</font>, se mantendrá.

