Saltar al contenido principal
Version: Next

Registrando Huarpe por linea de comandos

Requisitos previos

  • Tener un deploy funcional de Arai-Usuarios v3.3+

Registrando Huarpe

El proceso de registro de aplicaciones se realiza mediante una serie de comandos que garantizan la inicialización correcta de los datos. Para mayores detalles ver acá.

A continuación se detallan los pasos:

  1. En primer lugar es necesario correr el contenedor que permite realizar tareas administrativas sobre la instalación de Araí-Usuarios. Para esto se debe realizar el deploy de usuarios_cmd.yml de la siguiente forma:

    docker stack deploy  --with-registry-auth  -c prod/arai/util/usuarios_cmd.yml usr-cmd
  2. El servicio anterior requiere que el nodo que ejecuta los comandos Docker sea el mismo donde se despliega el stack usuarios, agregarle por tanto el labels.cmd=usuarios al nodo para que el servicio src-cmd se inicie:

    NODE_NAME=$(docker info --format '{{ .Name }}')
    docker node update --label-add cmd=usuarios $NODE_NAME
  3. Una vez se encuentra corriendo el contenedor, nos conectamos al mismo de la siguiente forma:

    docker exec -it ID_CONTENEDOR_USR_CMD bash
  4. Dentro del contenedor, primero exportar las variables de entorno:

    source /siu-entrypoint.d/01-prepare-secrets && set +e
  5. Luego invocar el comando de registro de aplicaciones:

    ./idm/bin/instalador app:registrar Huarpe https://uunn.local --permite-acceso-sin-cuenta --es-activa --logo-path /usr/local/app/files/huarpe.png

El registro efectivo de Huarpe generará como salida un mensaje exponiento el ID de Aplicación, ej:

 App creada: f4bd626e-c740-44de-a17a-b6fb49c7d9b3

Atención:

  • Copie el ID de Aplicación ya que lo necesitará para poder generar el conector correspondiente.
  • El path al logo es interno al contenedor, se recomienda copiar la imagen en el volumen mapeado o incluir un volumen extra en el stack.

Creando el Conector

El registro de la aplicación es el primer paso, luego se debe generar el conector que permitirá que Huarpe sea autenticable mediante el IDP. Para ello, dentro del mismo contenedor usaremos los siguientes comandos:

  1. Invocar el comando para el registro de conectores:

    ./idm/bin/instalador app:conector --tipo saml --app-unique-id f4bd626e-c740-44de-a17a-b6fb49c7d9b3  --saml-activo --saml-entity-id https://uunn.local/saml/metadata --saml-acs https://uunn.local/saml/acs --saml-sls https://uunn.local/saml/logout 
  2. Finalmente, para validar que Huarpe quedo correctamente registrado puede utilizar el siguiente comando especificando el ID de Aplicación

    ./idm/bin/instalador app:listar f4bd626e-c740-44de-a17a-b6fb49c7d9b3

    Se brindará el detalle de todos los datos incorporados, en caso de necesitar ajustes debera utilizar nuevamente los comandos previos incluyendo los datos originales y las modificaciones.