Ir al contenido

Conectar Okta

Okta envía los eventos a Identiguard mediante un event hook. Identiguard crea el hook por usted en cuanto recibe los datos de la integración de Identiguard en su org de Okta.

Se necesita:

  • Acceso de administrador a la org de Okta, con permiso para gestionar integraciones de servicio de API.
  • API Access Management habilitado en Security → API.
  • El rol Admin en el workspace de Identiguard. Los Member y los Viewer ven Only workspace admins can create tenants. (Solo los administradores del workspace pueden crear tenants.) y un botón Admin Access Required deshabilitado.
  • Un hueco de tenant libre en el plan. Consulte el límite de tenants del plan.

1. Añadir la integración de Identiguard en Okta

Sección titulada «1. Añadir la integración de Identiguard en Okta»
  1. Inicie sesión en la Okta Admin Console.
  2. Vaya a Applications → Applications y elija Browse App Catalog.
  3. Busque Identiguard y elija Add Integration.
  4. Revise el acceso que solicita y elija Install & Authorize.
  5. Copie el secreto de cliente. Okta lo muestra una sola vez.
  6. Deje la página abierta. En el paso siguiente necesitará el dominio de Okta y el ID de cliente que aparecen en ella.
  1. Abra el workspace y vaya a Tenants.
  2. En Create a tenant, busque la tarjeta Okta (subtítulo Workforce identity) y elija Connect. Se abre la página Add New Okta Tenant.
  3. Rellene el formulario. Todos los campos se describen en la tabla siguiente.
  4. En Event Subscriptions, marque los tipos de evento que quiere recoger. No hay nada marcado cuando se abre la página, y debe marcar al menos uno. Select All marca todos los tipos.
  5. Si lo desea, en Agent Monitoring, marque Monitor AD Agents o Monitor LDAP Agents y elija un Check Interval (minutes).
  6. Elija Create Okta Tenant. El botón muestra Creating… mientras Identiguard trabaja.
Sección Campo Reglas
Basic Details Tenant Name Obligatorio. 100 caracteres como máximo. Sin saltos de línea ni caracteres de control.
Basic Details Customer Name Obligatorio. El campo sugiere nombres de cliente ya usados en el workspace.
Basic Details Okta Domain Obligatorio. La URL base de la org, como https://login.example.com.
Basic Details Environment Obligatorio. Production o Development.
Basic Details Client ID Obligatorio. Procede de la integración de Identiguard en Okta.
Credentials Client Secret Obligatorio. El secreto que Okta mostró una sola vez.
Event Subscriptions Subscribed Event Types Al menos uno. El contador muestra N of M selected.
Agent Monitoring Monitor AD Agents, Monitor LDAP Agents Opcional. Ambos están desactivados de forma predeterminada.
Agent Monitoring Check Interval (minutes) Aparece cuando el monitor está marcado. Una lista fija: 5, 10, 15, 30, 60 o 120 minutos. El valor predeterminado es 15.

Los distintivos de la parte superior de la página muestran el workspace, Okta tenant y N event types selected. Back to Tenants y Cancel salen sin guardar.

  • Search event types… filtra la lista.
  • Select All marca todos los tipos. Mientras busca, pasa a ser Select All Visible y marca solo los tipos que están en pantalla.
  • Clear All lo desmarca todo.
  • El pie muestra Showing N event types.

Identiguard solo ofrece los tipos de evento que Okta acepta en un event hook. Si no está seguro de qué recoger, Select All es un punto de partida razonable, y más adelante puede quitar los tipos que generen ruido. Consulte Cambiar qué eventos envía un tenant.

  1. En un workspace en periodo de prueba, Identiguard primero inicia sesión en la org de Okta con el ID de cliente y el secreto para demostrar que usted la controla. Una org de Okta solo se puede usar en un periodo de prueba.
  2. Identiguard crea un event hook en la org de Okta, lo verifica y lo activa. El nombre del hook es IG_Tenant_<tenant name>_<environment>_WS_<first 8 characters of the workspace ID>.
  3. Vuelve a la página Tenants.
  1. En Okta, vaya a Workflows → Event Hooks.
  2. Abra el hook que ha creado Identiguard y vaya a Preview.
  3. Elija cualquier tipo de evento y elija Deliver Request.
  4. En Identiguard, abra Dashboard. El evento aparece en Real-time events.
Scope de Okta Se usa para
okta.eventHooks.manage, okta.eventHooks.read Crear y comprobar el event hook
okta.logs.read Leer el registro del sistema para los informes
okta.users.read, okta.factors.read Las secciones de usuarios y de MFA de los informes
okta.features.read La lista de funciones habilitadas en los detalles del tenant
okta.agentPools.read La monitorización de los agentes de AD y LDAP

Identiguard no cambia nada en Okta, aparte de su propio event hook.

  • Okta rechaza un hook entero si incluye un solo tipo de evento que los hooks no admiten. Identiguard solo ofrece los tipos que Okta acepta.
  • No se puede cambiar el dominio de Okta más adelante. Para pasar a otra org, elimine el tenant y créelo de nuevo.
  • Eliminar el tenant en Identiguard también desactiva y quita el event hook en Okta. Quite además la integración en Okta si el cliente se marcha. Consulte Gestionar tenants.
  • Para cambiar más adelante los tipos de evento, la monitorización de agentes o el nombre, consulte Gestionar tenants.
  • Para cambiar el secreto más adelante, consulte Rotar credenciales.

Los errores de campo se muestran en rojo debajo del campo. Los demás errores se muestran como un aviso emergente rojo. Un aviso que empieza por Failed to create tenant: (No se ha podido crear el tenant) procede del servidor.

Qué ve Por qué Qué hacer
“Only workspace admins can create tenants.” y un botón Admin Access Required deshabilitado Su rol es Member o Viewer Pida a un Admin del workspace que cree el tenant.
Abre la página de creación y vuelve a aparecer en Tenants Solo los Admin pueden abrir la página de creación Pregunte a un Admin del workspace.
“Tenant name cannot be empty” (El nombre del tenant no puede estar vacío) Tenant Name está en blanco Introduzca un nombre.
“Tenant name must be 100 characters or fewer” (El nombre del tenant debe tener 100 caracteres como máximo) El nombre es demasiado largo Acórtelo.
“Tenant name cannot contain line breaks or control characters” (El nombre del tenant no puede contener saltos de línea ni caracteres de control) El nombre se pegó con caracteres ocultos Escriba el nombre a mano.
“Customer name is required” (El nombre del cliente es obligatorio) Customer Name está en blanco Introduzca el cliente.
“Okta domain is required” (El dominio de Okta es obligatorio) Okta Domain está en blanco Introduzca la URL de la org.
“Enter Okta base URL (e.g., https://login.example.com)” (Introduzca la URL base de Okta) El dominio no es una URL base válida Introduzca la URL de la org con https:// y sin ruta.
“Environment is required” (El entorno es obligatorio) No se ha elegido ningún entorno Elija Production o Development.
“Client ID is required” (El ID de cliente es obligatorio) o “Client secret is required” (El secreto de cliente es obligatorio) El campo está en blanco Copie el valor de la integración en Okta.
“At least one event type must be selected” (Debe seleccionarse al menos un tipo de evento) No hay nada marcado en Subscribed Event Types Marque al menos un tipo.
“Invalid event type submitted” (Se ha enviado un tipo de evento no válido) La página envió un tipo que no está en la lista permitida Recargue la página y seleccione de nuevo los tipos.
Qué ve Por qué Qué hacer
“Failed to create tenant: The <Plan> plan allows up to N tenants per workspace, and this workspace already has M. Upgrade the plan to add more.” (El plan permite hasta N tenants por workspace, y este workspace ya tiene M. Suba de plan para añadir más.) El workspace ha llegado al límite de tenants de su plan Elimine un tenant que ya no necesite, o suba de plan. Consulte Planes y facturación.
“Failed to create tenant: This Okta org has already been used in another Identiguard trial, so it cannot be added to a new one. Choose a plan on the Billing page to add it, or contact Identiguard support.” (Esta org de Okta ya se ha usado en otro periodo de prueba de Identiguard, así que no se puede añadir a uno nuevo. Elija un plan en la página Billing para añadirla, o contacte con el soporte de Identiguard.) Workspace en periodo de prueba. Otro periodo de prueba ya usó esta org. Elija un plan de pago, o contacte con el soporte de Identiguard.
“Failed to create tenant: Identiguard could not sign in to this Okta org with the client ID and client secret provided, so it cannot be added. Check them and try again.” (Identiguard no ha podido iniciar sesión en esta org de Okta con el ID de cliente y el secreto de cliente indicados, así que no se puede añadir. Compruébelos e inténtelo de nuevo.) Workspace en periodo de prueba. Okta rechazó el ID de cliente y el secreto. Compruebe ambos valores. Compruebe que la integración está instalada y autorizada en Okta.
“Failed to create tenant: Identiguard could not reach this Okta org to check the client ID and client secret. Try again in a few minutes.” (Identiguard no ha podido contactar con esta org de Okta para comprobar el ID de cliente y el secreto de cliente. Inténtelo de nuevo en unos minutos.) Workspace en periodo de prueba. Okta no respondió. Compruebe el dominio y después inténtelo de nuevo en unos minutos.
“Failed to create tenant: Failed to create Okta Event Hook: <mensaje de Okta>” (No se ha podido crear el event hook de Okta) Okta rechazó el hook. Causas habituales: credenciales incorrectas, falta el scope okta.eventHooks.manage, o la org ha alcanzado su límite de event hooks. Lea el mensaje de Okta. Corrija las credenciales o el scope y después inténtelo de nuevo.
“Failed to create tenant: Failed to verify Okta Event Hook: <mensaje de Okta>” (No se ha podido verificar el event hook de Okta) Falló la llamada de verificación única de Okta a Identiguard Inténtelo de nuevo. Si se repite, escale al equipo de producto.
“Failed to create tenant: Failed to activate Okta Event Hook: <mensaje de Okta>” (No se ha podido activar el event hook de Okta) Okta se negó a activar el hook En Okta, abra Workflows → Event Hooks y quite cualquier hook IG_Tenant_ sobrante de este tenant. Después inténtelo de nuevo.
“Forbidden: You do not have permission to create tenants.” (Prohibido: no tiene permiso para crear tenants.) Su rol cambió mientras la página estaba abierta Pregunte a un Admin del workspace.
“Failed to create tenant: Bad Request” (Solicitud incorrecta) El servidor rechazó el formulario Revise de nuevo todos los campos. Escale si continúa.
“Failed to create tenant: API error” (Error de API) o “An unexpected error occurred: …” (Se ha producido un error inesperado) Un error inesperado Inténtelo de nuevo y después escale al equipo de producto.
“Failed to create tenant: Server configuration error…” (Error de configuración del servidor) Un problema de la plataforma Escale a un operador de la plataforma.
Qué ve Por qué Qué hacer
No hay confirmación después de elegir Create Okta Tenant La página Tenants no muestra un mensaje de confirmación Busque la nueva fila en Tenant overview.
No hay eventos en el Dashboard Todavía no ha ocurrido nada en la org, o el hook no está activo Envíe un evento de prueba (paso 3). En Okta, compruebe que el hook IG_Tenant_ está Active.
Un aviso emergente “<nombre del tenant> connection unhealthy” (conexión con problemas) Se rechazó una comprobación de agentes Consulte Estado de los tenants.