Registro, Edición y Eliminación de Direcciones de Entrada

Registrando una nueva dirección de entrada

Para registrar una nueva dirección de entrada (inbound address), haga clic en el botón Create Inbound Address, representado por el símbolo + en la esquina inferior derecha de la página Inbound Address.

Los campos que se deben rellenar varían según el tipo de puerta de enlace (gateway) del cliente y los protocolos admitidos.

Hybrid Gateway (puerta de enlace híbrida)

En el caso de implementación de la API Platform en un entorno híbrido, la responsabilidad de la seguridad de la comunicación recae en el cliente. Por lo tanto, independientemente del tipo de protocolo admitido, el usuario solo debe señalar la dirección de entrada y, a continuación, hacer referencia a esa dirección en el entorno de implementación de APIs deseado. Puede leer más sobre como configurar los entornos aquí.

create hybrid

Los campos obligatorios son:

  • Name: nombre que identifica la dirección de entrada. El nombre puede ser el mismo que la dirección de host configurada o algo más descriptivo.

  • Gateway Type: tipo de puerta de enlace (en este caso, seleccione Hybrid).

  • Protocol Type: tipo de protocolo aceptado (HTTP; HTTPS; o HTTP|HTTPS).

  • Host/Inbound Address: introduzca aquí la dirección de entrada. La dirección sera el host de los entornos de implementación de APIs.

En el caso de las puertas de enlace híbridas, no es necesario utilizar DNS. Puede introducir una dirección IP o una puerta.

SaaS Gateway (puerta de enlace SaaS)

Para las puertas de enlace de tipo SaaS, los campos que necesita configurar varían en función de los protocolos admitidos.

HTTP

Si el único protocolo soportado es HTTP, significa que no hay ninguna seguridad TLS aplicada. En este caso, el usuario solo necesita poner el host en formato DNS y luego hacer referencia a esa dirección en el entorno de implementación de API deseado. Puede leer más sobre como configurar los entornos aquí.

create saas http

Los campos obligatorios son:

  • Name: nombre que identifica la dirección de entrada. El nombre puede ser el mismo que la dirección de host configurada o algo más descriptivo.

  • Gateway Type: tipo de puerta de enlace (en este caso, seleccione SAAS).

  • Protocol Type: tipo de protocolo aceptado (seleccione HTTP).

  • Host/Inbound Address: introduzca aquí la propia dirección de entrada como DNS. La dirección sera el host de los entornos de implementación de APIs.

HTTPS o HTTP|HTTPS

Cuando el protocolo admitido es sólo HTTPS o HTTP y HTTPS (HTTP|HTTPS), puede elegir el tipo de seguridad aplicado: TLS o mTLS.

La opción TLS estipula que la identidad del servidor está garantizada mediante el envío de un certificado desde el gateway al cliente, pero el cliente no necesita pasar un certificado para su autenticación. En el caso de mTLS, el cliente (es decir, la aplicación que accederá a la dirección de entrada) también debe enviar un certificado válido al realizar peticiones al gateway.

En ambos casos, debe seleccionar un certificado que ya esté registrado en la pantalla Certificates. El certificado debe ser un inbound certificate (es decir, con la opción Inbound Certificate seleccionada). Puede ver más acerca del registro de certificados aquí.

Además de las opciones de seguridad, el usuario debe colocar el host en formato DNS y, a continuación, hacer referencia a esa dirección en el entorno de implementación de API deseado. Puede leer más sobre como configurar los entornos aquí.

create saas https mtls

Los campos a rellenar son los mismos en el caso de HTTPS o HTTP|HTTPS:

  • Name: nombre que identifica la dirección de entrada. El nombre puede ser el mismo que la dirección de host configurada o algo más descriptivo.

  • Gateway Type: tipo de puerta de enlace (en este caso, seleccione SAAS).

  • Protocol Type: tipo de protocolo aceptado (seleccione HTTPS o HTTP|HTTPS).

  • Host/Inbound Address: introduzca aquí la propia dirección de entrada como DNS. La dirección sera el host de los entornos de implementación de APIs.

  • Security: tipo de seguridad (TLS o mTLS).

  • TLS Version: dos campos para definir el espectro de versiones TLS admitidas. Opciones: versiones 1.0, 1.1, 1.2 y 1.3.

    • El campo de la izquierda (Min) debe contener la versión más antigua admitida, mientras que el campo Max debe contener la versión más actualizada compatible. Así, por ejemplo, si se elige 1.0 y 1.3, el cliente soportará todas las versiones (1.0 a 1.3). Si se elige 1.2 y 1.3, el cliente admitirá las versiones 1.2 y 1.3. Para admitir solo una versión, debe incluirla en ambos campos (por ejemplo, 1.3, 1.3). No puede configurar los campos con una versión seleccionada en el campo Min superior a la versión seleccionada en el campo Max.

Para mayor facilidad, estamos llamando a todas las versiones «versión TLS», pero el nombre oficial es SSL 1.0 y 1.1 y TLS 1.2 y 1.3. mTLS solo se aplica en TLS 1.2 y 1.3 (las versiones 1.0 y 1.1 están obsoletas).
  • Certificate: campo para seleccionar un certificado registrado en la pantalla Certificates.

    • El certificado debe ser un inbound certificate (es decir, con la opción Inbound Certificate seleccionada).

Editando una dirección de entrada

El botón de edición de direcciones se encuentra en la lista de inbound addresses existentes, en la columna Actions.

Para editar los datos de una dirección, haga clic en el icono icon edit y se le dirigirá a la pantalla de edición, que es la misma que la pantalla de creación de direcciones.

Cualquier modificación se reflejará en todos los entornos que tengan la dirección de entrada dada como host.

Eliminando una dirección de entrada

Para eliminar un inbound address, simplemente haga clic en el icono icon delete en la columna Actions de la lista de direcciones existentes y confirme la acción haciendo clic en el botón Confirm.

No es posible eliminar una dirección de entrada si está en uso en un entorno.
Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]