Certificados

El ecosistema Open Insurance Brasil recurre a las cadenas de certificados y al protocolo TLS para garantizar la confidencialidad, autenticación e integridad del canal de comunicación utilizado por las APIs de las instituciones participantes, así como de los clientes de cada uno de los participantes. Además, se requiere el certificado para:

Para realizar una conexión mTLS, se necesitan 3 certificados. Son:

Los certificados deben ser emitidos por una Autoridad de Certificación aprobada por ICP-Brasil. A continuación, se indican algunos de los que se pueden contactar:

Para registrarse en los certificados BrCAC y BrSEAL, debe haber creado una Declaración de software para su organización. Para hacerlo, siga estos pasos: 1. En el Directorio, acceda a su organización;
2. Vaya a Declarações de Software y haga clic en Declarações de novo software;
3. En la ventana que se abre, rellene los campos del formulario tal y como se detalla en la página 3 del Guía de creación de la declaración de software.

Los certificados tienen la opción de registrarse para los entornos Sandbox y Producción. Elija cuál desea registrar y siga los pasos:

Sandbox
1. En el Directorio, vaya al menú Organização;
2. Vaya a Declarações de Software y seleccione la declaración que desee;
3. Acceda a Certificados > Novo Certificado;

4. Seleccione la opción BRCAC_2022 y haga clic en Continuar;
5. En el siguiente paso, seleccione Geração automática de configuração;
6. Termine de rellenar los campos y descargue los ficheros brcac.cnf y brcac.sh. Verifique la definición de los atributos en la sección 5.2.2.1 del Portal del Desarrollador (en portugués);
7. Edite el archivo brcac.cnf con información idéntica a la del Directorio en la página Detalles de la Organización. He aquí un ejemplo utilizando OpenSSL:

8. Edite el archivo brcac.sh para que haga referencia a la ruta del archivo brcac.cnf;
9. Ejecute el archivo brcac.sh a través de la línea de comandos para generar el par CSR y KEY;
10. En el Directorio, seleccione la opción Carregar CSR/PEM, localice el brcac.csr generado y haga clic en Continuar;
11. Espere a que se cargue el archivo y haga clic en Feito.

Producción
1. En el Directorio, vaya al menú Organização;
2. Vaya a Declarações de Software y seleccione la declaración deseada;
3. Acceda a Certificados > Novo Certificado; +. 4. Seleccione la opción EXTERNAL BRCAC y haga clic en Continuar;
5. En la opción Gerar CSR, haga clic en Continuar. El EXTERNAL BRCAC es emitido por la autoridad de certificación, por lo tanto, no hay proceso de generación de certificado.
6. Seleccione la opción Carregar CSR/PEM y localice el fichero CSR o PEM emitido por la autoridad de certificación;
7. Haga clic en Continuar;
8. Espere a que se cargue el archivo y haga clic en Feito.

Los certificados tienen la opción de registrarse para los entornos Sandbox y Producción. Elija cuál desea registrar y siga los pasos:

Sandbox
1. En el Directorio, vaya al menú Organização;
2. Vaya a Certificados de Organização > Novo Certificado;

3. En la ventana que se abre, seleccione la opción BRSEAL en el campo Select Certificate Type;
4. En el siguiente paso, seleccione Geração automática de configuração;
5. Termine de rellenar los campos y descargue los ficheros brseal.cnf y brseal.sh;
Verifique la definición de los atributos en la sección 5.2.3.1 del Portal del Desarrollador (en portugués);
6. Edite el archivo brseal.cnf con información idéntica a la del Directorio en la página Detalles de la Organización. He aquí un ejemplo utilizando OpenSSL:

7. Edite el archivo brseal.sh para que haga referencia a la ruta del archivo brseal.cnf;
8. Ejecute el archivo brseal.sh a través de la línea de comandos para generar el par CSR y KEY;
9. En el Directorio, seleccione la opción Carregar CSR/PEM, localice el brseal.csr generado y haga clic en Continuar;
10. Espere a que se cargue el archivo y haga clic en Feito.

Producción
1. En el Directorio, vaya al menú Organização;
3. Acceda a Certificados de Organização > Novo Certificado;
4. Seleccione la opción BRSEAL EXTERNAL y haga clic en Continuar;
5. En la opción Gerar CSR y haga clic en Continuar;
El EXTERNAL BRCAC es emitido por la autoridad de certificación, por lo tanto, no hay proceso de generación de certificado.
6. Seleccione la opción Carregar CSR/PEM y localice el fichero CSR o PEM emitido por la autoridad de certificación;
7. Haga clic en Continuar;
8. Espere a que se cargue el archivo y haga clic en Feito.

Cuando se realiza el registro del certificado BrSEAL en el Directorio de Participantes, se devuelve automáticamente el ID de la clave única (KID).

El Estándar de Certificados de Open Insurance Brasil especifica las cadenas para cada tipo de certificado, siendo: * Certificado del servidor: debe enviarse con la cadena intermedia, según el punto 7.4.2. del RFC5246. * Certificado de cliente (BrCAC - Transporte): debe enviarse con la cadena intermedia según los puntos 7.4.2 y 7.4.6 del RFC5246 y ser emitido a través de la cadena V10,además de contener obligatoriamente los atributos:

Vaya a Security > Certificates y siga los pasos:
1. En la pantalla de certificados, haga clic en el icono + para introducir un nuevo registro; 2. Rellena los campos: * Name * Certificate Body * Private Key * Certificate Chain

3.Después de rellenar los campos, haga clic en Save. Se le redirigirá a la pantalla en la que aparecen los certificados registrados.