Chapter 3

Manuales

Info

Para facilitar su interacción con nuestro equipo, le proporcionamos un conjunto de manuales básicos que le servirán de guía, estos manuales incluyen información sobre el funcionamiento y el uso de los diferentes componentes y herramientas, así como instrucciones detalladas sobre cómo realizar tareas específicas. Además, encontrará consejos útiles y recomendaciones de seguridad.

Esperamos que estos manuales le resulten de gran utilidad y le agradecemos de nuevo por confiar en nosotros. Si tiene alguna duda o necesita más información, no dude en ponerse en contacto con nosotros.

  • Actualización de contenido estático en Telmex StaaS

    Info Este manual explica el proceso para añadir o modificar contenido de un sitio que está utilizando la herramienta de almacenamiento de recursos Amazon S3, detallando los pasos requeridos para configurar la AWS CLI y llevar a cabo las actualizaciones necesarias. 1. Prerrequisitos AWS CLI instalada (Consulta la documentación oficial. ) Credenciales de acceso a AWS con permisos adecuados. 2. Configuración de AWS CLI La carga de contenido en sitios estáticos con almacenamiento en Amazon S3, utilizan AWS CLI.

  • Manual de OTRS

    OTRS Info El sistema de tickets es una herramienta útil para poder dar seguimiento a cada una de la soliciudes y controles de cambio, nos permite iterativamente estandarizar procesos y procedimientos para proporcionar consistencia y certidumbre a nuestros clientes y usuarios finales. El presente manual contiene la información necesaria para levantar una solicitud o incidencia, dar seguimientoo retroalimenatación y cierre en OTRS. Acceso a OTRS El usuario ingresa al sistema OTRS al teclear en su buscador la siguiente URL: https://otrs.

  • Configuración OpenVPN MacOS

    Note El presente manual se emite exclusivamente como instrumento de apoyo para las áreas competentes en la administración, custodia, y soporte de equipos de cómputo local (laptops o computadoras) para cumplimentar la solicitud de soporte de infraestructura para el trámite de acceso por VPN mediante la creación de Llaves RSA. Este documento es de carácter práctico, queda bajo total responsabilidad de los clientes el: uso, aseguramiento, resguardo, mantenimiento, y tratamiento de los artefactos generados.

  • Creación de llaves para OpenVPN

    Llaves RSA Info Las llaves RSA son un tipo de criptografía asimétrica que se utiliza para asegurar la comunicación y proteger la información. La criptografía asimétrica se basa en la utilización de dos llaves: una pública y otra privada. La llave pública se puede compartir abiertamente, mientras que la llave privada debe mantenerse en secreto. Cuando se envía un mensaje cifrado con la llave pública, solo puede ser descifrado con la llave privada correspondiente.

  • Crear servicio - Backstage

    Para que sirve esta pagina Esta pagina te ayuda a registrar un servicio en Backstage y, si lo necesitas, dejar listo su flujo de integracion y despliegue. Al finalizar tendras: El servicio visible en Backstage. La relacion del servicio con su proyecto y su equipo. El registro del servicio en el repositorio. El pipeline de CI/CD, si elegiste crearlo. Antes de comenzar Antes de llenar el formulario, ten a la mano esta informacion:

  • Gravitee Api Manager

    Introducción Info Gravitee es una solución integral para la gestión de API, que ayuda a los desarrolladores a crear, desplegar y monitorear sus API de manera eficiente, proporciona una serie de herramientas para el desarrollo, el despliegue, la seguridad y la monitorización. Inicio rápido Gravitee API Manager consta de dos componentes principales para desarrolladores: Consola de administración proporciona una interfaz web para administrar y configurar las APIs. Portal para desarrolladores proporciona una interfaz para que los desarrolladores registren, documenten, prueben y monitoreen las APIs.

  • Guía de actualización MySQL 5.7 a 8.0

    Warning El ciclo de vida de MySQL 5.7 terminó el 21 de Octubre de 2023. A fin de mantener soporte y actualizaciones de seguridad todas las instancias que tengan este motorbases de datos con esta versión deben de ser actualizados. Info Antes de realizar un upgrade a MySQL 8, tanto los usuarios como los desarrolladores deben considerar una serie de aspectos importantes para garantizar una transición fluida y minimizar posibles problemas.

Subsections of Manuales

Actualización de contenido estático en Telmex StaaS

Info

Este manual explica el proceso para añadir o modificar contenido de un sitio que está utilizando la herramienta de almacenamiento de recursos Amazon S3, detallando los pasos requeridos para configurar la AWS CLI y llevar a cabo las actualizaciones necesarias.

1. Prerrequisitos

  • AWS CLI instalada (Consulta la documentación oficial. )

  • Credenciales de acceso a AWS con permisos adecuados.

2. Configuración de AWS CLI

La carga de contenido en sitios estáticos con almacenamiento en Amazon S3, utilizan AWS CLI. Presentamos los pasos para preparar la misma.

  1. Establecimiento de Credenciales
    Después de instalar AWS CLI, usa el siguiente comando para ajustar tu usuario:
aws configure

Con aws configure se establecerán los parámetros del propio usuario. Los campos AWS Access Key ID y AWS Secret Access Key deberán ser llenados con las credenciales previamente proporcionadas para su acceso. Se recomienda utilizar el nombre de la región cómo mxqr y el formato de salida por defecto cómo text

imagen01 imagen01

Una vez configurado su usuario de aws s3, puedes ejecutar el siguiente comando para listar el contenido del bucket:

 aws s3 ls s3://<nombre-bucket>/ --endpoint-url https://s3-mxqr.almnube.telmex.com --no-verify-ssl

Desglosando el comando anterior:

  • aws s3 – > Comando para conexión a s3 de por aws cli

  • ls —> Comando list

  • s3://< nombre-bucket >/ —> Indicador s3, asegúrate de configurar el nombre correspondiente del bucket.

  • –endpoint-url https://s3-mxqr.almnube.telmex.com —> Endpoint de consulta para s3-telmex

imagen02 imagen02

3. Actualización de contenido sobre sitio estático

La carga de contenido se realizará mediante la interfaz de comandos de AWS, la cuál se instaló y configuró previamente.

Supongamos que se quiere visualizar contenido en la ruta https://<dominio-productivo>/ruta/contenido/imagen-carga-de-prueba.png , donde imagen-carga-de-prueba.png es el archivo que desea revisar como parte de los cambios recientes.

El bucket especificado es s3://<nombre-bucket>/, por lo que el contenido, a partir del primer /, se reflejará directamente en el sitio productivo.

Para visualizar el cambio, usaremos el contexto /ruta/contenido/imagen-carga-de-prueba.png y lo agregaremos al comando de carga de la siguiente manera:

 s3://<nombre-bucket>/ruta/contenido/imagen-carga-de-prueba.png

Este será el archivo que se desea modificar

Ubica la ruta de tu archivo localmente y usa el siguiente comando para subir el archivo /ruta/contenido/imagen-carga-de-prueba.png

 aws s3 cp /home/user/Downloads/imagen-carga-de-prueba.png s3://<nombrebucket>/ruta/contenido/imagen-carga-de-prueba.png --endpoint-url https://s3-mxqr.almnube.telmex.com --no-verify-ssl

Visto en la terminal de la siguiente manera

imagen03 imagen03

Desglosando el comando anterior:

  • aws s3 – > Comando para conexión a s3 de por aws cli

  • cp —> Comando copy

  • /home/user/Downloads/imagen-carga-de-prueba.png —> Archivo local

  • s3://<nombre-bucket>/ruta/contenido/imagen-carga-de-prueba.png —> Endpoint del dominio productivo donde se desea visualizar el contenido

  • –endpoint-url https://s3-mxqr.almnube.telmex.com —> Endpoint de consulta para s3-telmex

Obteniendo como resultado final la imagen cargada sobre la ruta https://<dominio-productivo>/ruta/contenido/imagen-carga-de-prueba.png


Ejemplo de carga de contenido en Telmex StaaS

  1. Visualizar Contenido en el Sitio

En este modelo se pretende visualizar un archivo para el sitio https://bucket-testing.prod.amxdigital.net en la ruta /portal/recursos-estaticos/imagen-carga-de-prueba.png, el archivo debe subirse en el bucket designado, para este caso será s3://bucket-test/ en la ubicación /portal/recursos-estaticos/imagen-carga-de-prueba.png

  1. Ubicación del archivo local

Localiza el archivo en tu máquina local, por ejemplo:

/home/user/imagen-carga-de-prueba.png

  1. Subir el contenido

El siguiente comando ejemplifica cómo subir un archivo al bucket de S3 utilizando las instrucciones descritas anteriormente.

 aws s3 cp /home/user/Downloads/imagen-carga-de-prueba.png s3://bucket-test/portal/recursos-estaticos/imagen-carga-de-prueba.png --endpoint-url https://s3-mxqr.almnube.telmex.com --no-verify-ssl

imagen04 imagen04

  1. Resultado final

El archivo subido estará disponible en la URL:

https://bucket-testing.prod.clarodigital.net/portal/recursos-estaticos/imagen-carga-de-prueba.png

imagen05 imagen05


Diagrama de flujo del proceso

Ejemplo programático con python

import boto3
from botocore.config import Config
from botocore.exceptions import NoCredentialsError, PartialCredentialsError

# Configuración
S3_ENDPOINT = "https://s3-mxqr.almnube.telmex.com"
ACCESS_KEY = "your-access-key"
SECRET_KEY = "your-secret-key"
BUCKET_NAME = "your-bucket-name"

# Crear cliente S3
def create_s3_client():
    try:
        client = boto3.client(
            "s3",
            endpoint_url=S3_ENDPOINT,
            aws_access_key_id=ACCESS_KEY,
            aws_secret_access_key=SECRET_KEY,
            config=Config(signature_version="s3v4"),
        )
        return client
    except (NoCredentialsError, PartialCredentialsError) as e:
        print(f"Error en las credenciales: {e}")
        return None

# Subir un archivo
def upload_file(file_path, object_name):
    s3_client = create_s3_client()
    if s3_client:
        try:
            s3_client.upload_file(file_path, BUCKET_NAME, object_name)
            print(f"Archivo {file_path} subido como {object_name}")
        except Exception as e:
            print(f"Error al subir el archivo: {e}")

# Descargar un archivo
def download_file(object_name, download_path):
    s3_client = create_s3_client()
    if s3_client:
        try:
            s3_client.download_file(BUCKET_NAME, object_name, download_path)
            print(f"Archivo {object_name} descargado a {download_path}")
        except Exception as e:
            print(f"Error al descargar el archivo: {e}")

# Generar una liga firmada (Manejo de ligas para actualización pública de objetos).
def generate_presigned_url(object_name, expiration=3600):
    s3_client = create_s3_client()
    if s3_client:
        try:
            url = s3_client.generate_presigned_url(
                "get_object",
                Params={"Bucket": BUCKET_NAME, "Key": object_name},
                ExpiresIn=expiration,
            )
            return url
        except Exception as e:
            print(f"Error al generar la liga firmada: {e}")
            return None

# Ejemplo de uso
if __name__ == "__main__":
    # Subir un archivo
    upload_file("local_file.txt", "uploaded_file.txt")

    # Descargar un archivo
    download_file("uploaded_file.txt", "downloaded_file.txt")

    # Generar una liga firmada
    url = generate_presigned_url("uploaded_file.txt")
    if url:
        print(f"Liga firmada: {url}")

Manual de OTRS

OTRS

Info

El sistema de tickets es una herramienta útil para poder dar seguimiento a cada una de la soliciudes y controles de cambio, nos permite iterativamente estandarizar procesos y procedimientos para proporcionar consistencia y certidumbre a nuestros clientes y usuarios finales. El presente manual contiene la información necesaria para levantar una solicitud o incidencia, dar seguimientoo retroalimenatación y cierre en OTRS.

Acceso a OTRS

  1. El usuario ingresa al sistema OTRS al teclear en su buscador la siguiente URL:

https://otrs.amxdigital.net/otrs/customer.pl

Aparecerá la página de acceso al sistema:

Acceso al sistema Acceso al sistema

  1. El usuario ingresa el nombre de usuario “Username” y contraseña “Password” y pulsa sobre el botón “log In”

  2. La página de inicio que aparece es la siguiente:

pagina de inicio pagina de inicio

Creación de una solicitud

  1. Para la creación de una nueva solicitud, un usuario autenticado navega sobre el menú de inicio del sistema, identifica el botón “Tickets” y pulsa sobre el botón para desplegar un menú. Para crear una nueva solicitud, pulsar sobre la opción “New Ticket”.

creación de solicitud creación de solicitud

  1. Posterior a la selección de New Ticket, se despliega el asistente de creación de solicitudes.

nuevo ticket nuevo ticket

  1. Aparece en pantalla un botón con la frase “Seleccione un componente”, se debe pulsar el botón para desplegar un menú para visualizar la lista de posibles tipos de solicitudes.

tipos de solicitud tipos de solicitud

Tipos de Solicitudes

  • Reporte de Incidente: Afectación o interrupción en la funcionalidad de un servicio.

incidentes incidentes

  • Operaciones recurrentes: Solicitudes estandarizadas y repetibles para mantener activo un servicio

operaciones recurrentes operaciones recurrentes

  • Control de Cambios: Solicitudes únicas que impactan arquitectura, topología de red o seguridad.

control de cambios control de cambios

Llenado de Formato

  1. Una vez seleccionado el componente específico, se despliegan en pantalla las opciones para “crear solicitud” o “reportar incidencia”

incidencia1 incidencia1

incidencia2 incidencia2

  1. Una vez que se haya seleccionado la opción, se abre una nueva ventana que contiene el formato vigente de solicitud o incidencia correspondiente a la selección previa:

formato vigente formato vigente

  • En la sección “To” aparecen las iniciativas a las que tiene acceso y debe seleccionar la iniciativa a la que va dirigida la solicitud. En caso de que su iniciativa no aparezca favor de contactar a Cecilia Martínez (cecilia.martinez@americamovil.com) para dar de alta la iniciativa correspondiente para AMX o a Rafael Herández Meza (rafael.hernandez@claroshop.com) para dar de alta la iniciativa correspondiente para GS

  • Incluir toda la información solicitada en el formato. En caso de dejar información en blanco,esta se solicitará hasta que este completa.

  • En la sección “Priority” De preferencia colocar “Default”, ya que esta es asignada por el equipo de Infraestructura.

  1. Finalmente deberá oprimir el botón “Submit” para generar la solicitud.

Seguimiento de Solicitudes

Visualización de mis tickets

  1. El usuario puede visualizar sus solicitudes al dirigirse al menú de opciones para tickets y seleccionar la opción “My tickets”, en consecuencia, aparecerá en pantalla un listado con las solicitudes generadas por el usuario para su consulta.

visualización de tickets visualización de tickets

  1. Todas las solcitudes tienen una confirmacioń automática de recepción, a partir de ese momento el equipo de infraestructura revisará que la prioridad marcada sea adecuada o este bien justificada y revisará que el formato tenga toda la información. En caso de encontrar dudas el equipo de infraestructura le solicitará la información necesaria.

  2. Para obtener más información de la solicitud, presione sobre el nombre y aparecerá en pantalla un listado con los mensajes y la información relacionada con esa solicitud.

información información

  • Ticket Number: Es el identificador único de solicitud en el sistema OTRS.
  • State: Es el estado en que se encuentra la solicitud.
  • Priority: Es la prioridad de la solicitud asignada por el equipo de Infraestructura
  • Queue: Es la inicitiva de la solicitud.

información2 información2

Estados de una solicitud

Estado de Ticket Criterio
Pending Missing Information Se identificó que la solicitud carece de información necesaria para ejecutar la solicitud y el usuario deberá proporcionar la información de acuerdo a las indicaciones del equipo de Infraestructura.
Pending Authorization Se identificó que el solicitante no tiene autorización para generar la solicitud y esta requiere de la aprobación del responsable correspondiente para ejecutarse.
Awaiting Scheduled Time Se identificó que la solicitud tiene una fecha y hora indicada para ejecutarse dentro de las instrucciones de la solicitud.
Awaiting Precedent Requirement Se identificó que es necesaria la ejecución de alguna solicitud previa antes de ejecutar la solicitud generada.
Queued-L2 La solicitud está en atención de un líder técnico especializado.
Pending Validation La solicitud tiene una respuesta de atención por parte del equipo de infraestructura que el usuario deberá validar.
Closed Successful//Closed Without Validation La respuesta por parte del equipo de infraestructura fue validada por el usuario. // La solicitud ha pasado dos días hábiles en “Pending Validation”

Solicitudes del mismo País o Iniciativa

El sistema de tickets OTRS, permite a los usuarios de un mismo país o iniciativa dar seguimiento a las solicitudes generadas por otros usuarios que igualmente pertenezcan al mismo país o iniciativa.

Para esta tarea el usuario deberá dirigirse al menú de opciones Tickets y seleccionar la opción “Company Tickets”, se desplegará un listado con todas las solicitudes generadas por el mismo país o iniciativa. En caso de necesitar más información sobre alguna solicitud específica, deberá pulsar sobre el nombre de la solicitud y aparecerán los detalles de dicha solicitud.

misma iniciativa misma iniciativa

Seguimiento a Incidentes

Para la atención de incidentes es necesario otorgar la mayor cantidad de información disponible para la pronta resolución de esta y estar en constante comunicación con el equipo de infraestructura. Por favor tomar en cuenta que los incidentes se atienden con la máxima prioridad posible, un falso positivo puede retrasar otras solicitudes importantes, asegurarse de que en verdad se trata de una incidencia permite mantener mejores flujos de trabajo.

Autorización solicitudes BAU

  1. Las solicitudes recurrentes para ambientes productivos deberán tener por lo menos la autorización del Líder de Iniciativa o Proyecto.

  2. Para ello, en caso de que la solicitud no sea levantada directamente por el líder de Iniciativa o Proyecto, se soliciatará la autorización correspondiente.

Autorización y Aprobación de solicitudes RFC

  1. Las solicitudes de cambio, que por su naturaleza, impactan la arquitectura, topología de red o seguridad, necesitan además de la autorización del Líder de Iniciativa o Proyecto, la aprobación del Gerente de Infraestructura correspondiente.

  2. Para ello se solicitará la autorización del Líder de Iniciativa o Proyecto y posteriormente se informará de un estimado de tiempo para la aprobación del Gerente de Infraestructura o en su defecto las acciones a seguir para evaluar el cambio.

Retroalimentación de una Solicitud

  1. El usuario puede dar retroalimentación, pulsando sobre el botón “Reply”, aparecerá una forma web con campos que no se recomiendan modificar, así como un campo de texto libre donde puede colocar, según sea el caso, la información faltante, la autorización correspondiente o la validación del ticket. Para finalizar el proceso, se debe pulsar sobre el botón “submit”.

retro1 retro1

retro2 retro2

  1. Igualmente si su correo esta copiado en la línea de tickets, puede contestar el correo de la misma manera como contestaria algún otro correo desde su cliente de correo electrónico.

Cierre de una Solicitud.

Todos los tickets

  1. Una vez que el requerimiento haya sido atendido y no se cuente con retroalimentación relevante a la correcta ejecución de las actividades originadas en la solicitud, se deberá proceder al correcto cierre de la solicitud. Para realizar el cierre de solicitud se debe utilizar la forma de retroalimentación de una solicitud y escribir:

“Validado, favor de cerrar ticket” y presionar el botón “Submit”

validacion validacion

Recuperación de contraseña de OTRS

  1. El usuario deberá presionar el botón “Forgot password?”

recuperación de contraseña recuperación de contraseña

  1. Después, deberá ingresar su nombre de usuario “User name” y presionar el botón “submit” para generar una nueva contraseña que podrá ser revisada en el correo con el que fue dado de alta.

recuperación de contraseña2 recuperación de contraseña2

Configuraciones en OTRS

En la página de inicio de OTRS presionar el botón “Preferences” donde se pueden cambiar parámetros como la contraseña, el lenguaje, el intervalo de actualiación de información y el número de tickets desplegados por página.

configuración otrs configuración otrs

Configuración OpenVPN MacOS

Note

El presente manual se emite exclusivamente como instrumento de apoyo para las áreas competentes en la administración, custodia, y soporte de equipos de cómputo local (laptops o computadoras) para cumplimentar la solicitud de soporte de infraestructura para el trámite de acceso por VPN mediante la creación de Llaves RSA. Este documento es de carácter práctico, queda bajo total responsabilidad de los clientes el: uso, aseguramiento, resguardo, mantenimiento, y tratamiento de los artefactos generados. El equipo de infraestructura se deslinda de cualquier intervención o solicitud de soporte para la: ejecución, implementación o supervisión de procedimientos a equipos locales por quedar fuera del tramo de responsabilidad, limitando su participación a la atención de la disponibilidad del servicio de autenticación, autorización y conectividad al servicio de VPN y la subsecuente conectividad entre los servicios de TIC soportados dentro de la misma.

Prerrequisitos

  • Certificado de Autoridad (CA)
  • Certificado del usuario, este es personal
  • Llave privada, la misma con la que se generó el CSR
  • Tener instalado OpenVPN

Procedimiento

1.- Deberás descargar todos los recursos necesarios y colocarlos en un directorio especifico para esta configuración

imagen01 imagen01

2.- Ahora crea un nuevo archivo en este directorio, que se llame auth.

Debe contener el usuario y contraseña de la vpn compartidos para tu acceso

imagen02 imagen02

3.- Crea otro archivo que identifiques, con la extensión " .ovpn " y el contenido debe ser similar a este ejemplo

Es necesario editar aquellos detalles como nombres, ip, puertos, etc.

imagen03 imagen03

4.- Ahora iniciamos openvpn, y veremos la interfaz de esta tecnología

imagen04 imagen04

5.- Hacemos clic en las tres lineas de la parte superior derecha

imagen05 imagen05

6.- vamos a la sección “File” y seleccionamos “Browser”

imagen06 imagen06

7.- Buscamos y cargamos el archivo “.ovpn” que creamos

imagen07 imagen07

8.- De estar correcta la información, nos actualizará la pantalla y solo basta con hacer clic en “ADD”

imagen08 imagen08

9.- Nos regresará a la pantalla de inicio, entonces podemos presionar el botón de encendido y se conectará

imagen09 imagen09

10.- Listo, tu vpn esta activa. Si te desplazas hacia abajo, puedes ver la información como ip asiganda, ip servidor, puerto, protocolo

imagen10 imagen10

Creación de llaves para OpenVPN

Llaves RSA

Info

Las llaves RSA son un tipo de criptografía asimétrica que se utiliza para asegurar la comunicación y proteger la información. La criptografía asimétrica se basa en la utilización de dos llaves: una pública y otra privada. La llave pública se puede compartir abiertamente, mientras que la llave privada debe mantenerse en secreto. Cuando se envía un mensaje cifrado con la llave pública, solo puede ser descifrado con la llave privada correspondiente. De esta manera, si alguien intercepta el mensaje, no podrá leerlo sin conocer la llave privada.

Note

El presente manual se emite exclusivamente como instrumento de apoyo para las áreas competentes en la administración, custodia, y soporte de equipos de cómputo local (laptops o computadoras) para cumplimentar la solicitud de soporte de infraestructura para el trámite de acceso por VPN mediante la creación de Llaves RSA. Este documento es de carácter práctico, queda bajo total responsabilidad de los clientes el: uso, aseguramiento, resguardo, mantenimiento, y tratamiento de los artefactos generados. El equipo de infraestructura se deslinda de cualquier intervención o solicitud de soporte para la: ejecución, implementación o supervisión de procedimientos a equipos locales por quedar fuera del tramo de responsabilidad, limitando su participación a la atención de la disponibilidad del servicio de autenticación, autorización y conectividad al servicio de VPN y la subsecuente conectividad entre los servicios de TIC soportados dentro de la misma.

Creación de llaves por tipo de sistema Operativo

    flowchart  TD
    
     id1["<b>¿Qué tipo de Sistema Operativo tengo?</b>"]
               id1 -->id2[<a>Windows</a>]
               id1 -->id3[<a>Linux</a>]
               id1 -->id4[<a>Mac</a>]

click id2 href "/clientes/manuales/llavesrsa-manual/#windows"
click id3 href "/clientes/manuales/llavesrsa-manual/#linux"
click id4 href "/clientes/manuales/llavesrsa-manual/#mac"

Windows

Note

Ésta guía está basada en Windows XP para fines demostrativos.

Obtener cliente de OpenVPN

  1. Obtener el cliente de openvpn que mejor se adapte al sistema operativo y versión actual
Note

La versión 2.4.9 ha sido reportada como no compatible).

imagen01 imagen01

  1. Ejecute el instalador de su sistema operativo de acuerdo a los procedimientos intrínsecos de la misma.

imagen02 imagen02

Note

Asegúrese de instalar los componentes de OpenSSL.

imagen03 imagen03

Note

Acepte las alertas de seguridad cuando su SO le pregunte si desea instalar los drivers no seguros.

imagen04 imagen04

imagen05 imagen05

  1. Finalice instalación

imagen06 imagen06

Pasos previos

  1. Mueva el directorio easy-rsa a una ruta fácil de administrar.

c:\Archivos de programa\OpenVPN>move easy-rsa ../../

  1. Genere un directorio de llaves

c:\Archivos de programa\OpenVPN\easy-rsa>mkdir keys

Creación de llave privada

Warning

NUNCA COMPARTA EL .key FILE

  1. Para construir su llave privada utilice el siguiente comando:

openssl req -days 365 -nodes -new -keyput keys/name.lastnamen

imagen07 imagen07

Enviar CSR para firmar

  1. Deberá de enviar su CSR a firmar de acuerdo al formato 2. CREACIÓN O ACTUALIZACIÓN DE CERTIFICADOS DE USUARIO

imagen08 imagen08

  1. Se le regresarán dos archivos: su certificado firmado y la CA. Instale el certificado de la CA en el repositorio de certificados de su sistema operativo.

imagen09 imagen09

imagen10 imagen10

imagen11 imagen11

imagen12 imagen12

imagen13 imagen13

Arranque y Validación de VPN

  1. Después de instalar el certificado de la CA, la firma del certificado que se le entregó será marcado como “de confianza”.

imagen14 imagen14

  1. Edite y almacene el archivo de configuración.

imagen15 imagen15

  1. Una vez que haya guardado dicho archivo de click en “Start OpenVPN on this config file”

imagen16 imagen16

  1. Podrá apreciar una conexión exitosa si las rutas de la vpn son agregadas a su sistema.

imagen17 imagen17

imagen18 imagen18

Linux

Generar Llave privada

Warning

ARCHIVO PRIVADO - ¡NO COMPARTIR NUNCA!

openssl genrsa -des3 -out nombre.apellido.key 4096
Note

En linux, después de generar el key, de preferencia se deben cambiar los permisos para sólo lectura del usuario de creación.

chmod 600 nombre.apellido.key

Generar llave pública

Note

Se debe utilizar la llave privada creada en el punto anterior

ssh-keygen -y -f nombre.apellido.key > nombre.apellido.pub    

Generar CSR

Generar el archivo CSR para solicitar acceso por VPN y SSH

openssl req -out nombre.apellido.csr -key nombre.apellido.key -sha256 -new

Un ejemplo de llenado es el siguiente:

Organization Name(Company) Grupo Carso
Organizational Unit Name (department, division) Gerencia de Sistemas
Email Address correo@correocorporativo.com
Locality Name (city, district) CDMX
Country Name (2 letter code) MX
Common Name (hostname, IP, or your name) Julio Florencio Cortázar

Verificar el archivo

Para CSR

openssl rsa -in nombre.crt -noout -text

para .key

openssl rsa -in nombre.key -noout -text
Note

El valor de módulo debe ser igual, también se puede verificar las primeras 6 letras y las últimas 6, deben de coincidir.

MAC

Chapter 2

Crear servicio - Backstage

Para que sirve esta pagina

Esta pagina te ayuda a registrar un servicio en Backstage y, si lo necesitas, dejar listo su flujo de integracion y despliegue.

Al finalizar tendras:

  • El servicio visible en Backstage.
  • La relacion del servicio con su proyecto y su equipo.
  • El registro del servicio en el repositorio.
  • El pipeline de CI/CD, si elegiste crearlo.

Antes de comenzar

Antes de llenar el formulario, ten a la mano esta informacion:

  • El nombre del proyecto o iniciativa al que pertenece el servicio.
  • El nombre del servicio.
  • El equipo responsable.
  • El grupo de GitLab dueño del repositorio.
  • El nombre del repositorio.
  • El nombre real del proyecto en GitLab, si vas a crear pipeline.
  • El lenguaje del servicio, si vas a crear pipeline.

Donde entrar

Ingresa a la siguiente direccion:

https://corehub.amxdigital.net/create/templates/default/service-simple-register-ci-promotion

Luego inicia sesion con tus credenciales habituales.

Como llenar el formulario

Sigue los campos en este orden.

1. Que deseas hacer

Aqui debes elegir el escenario que mejor describe tu caso.

Crear nuevo repositorio vacio para un servicio

> Usa esta opcion cuando todavia no existe repositorio y vas a comenzar desde cero.

Agregar un servicio nuevo con repositorio existente

> Usa esta opcion cuando el repositorio ya existe y solo quieres registrar el servicio y dejar su configuracion lista.

Actualizar servicio y su repositorio

> Usa esta opcion cuando el servicio ya existe y necesitas corregir o actualizar su informacion.

2. Nombre del proyecto o iniciativa

Selecciona de la lista el proyecto al que pertenece el servicio.

Todos los servicios de una misma iniciativa deben usar el mismo proyecto. Eso ayuda a que queden agrupados correctamente en Backstage.

Ejemplos de proyecto:

  • Alertas Competencia
  • Dashboard Digital
  • Portal Comercial GT
  • Telcel Carrito
  • Sustentabilidad

3. Nombre del servicio

Es el nombre principal del servicio.

Ese nombre se usara como referencia en varios lugares, por ejemplo en Backstage y en recursos creados para el servicio.

Recomendacion:

  • Usa un nombre claro.
  • NO uses espacios.
  • Usa el mismo nombre que ya maneja el equipo si el servicio ya existe.

Sigue la siguiente formula para nombrar los aplicativos:

amx-{Iniciativa}-{servicio}

Por ejemplo,

  • Un servicio llamado “Reporte Catalogo Uni”
  • Parte de la iniciativa “Portal Reportes EC”

El nombre es:

amx-portal-reportes-ec-reporte-catalogo-uni

  • Un servicio llamado “Planes Promo MS BE”
  • Parte de la iniciativa “Portal Reportes EC”

El nombre es:

amx-portal-reportes-ec-planes-promo-ms-be

  • Un servicio llamado “Authentication”
  • Parte de la iniciativa “Registro Ventas”

El nombre es:

amx-registro-ventas-authentication

  • Un servicio llamado “SSOLoginRedisV2.4”
  • Parte de la iniciativa “App CENAM”

El nombre es:

amx-app-cenam-sso-login-redis-v2-4

4. Que tipo de componente es

Selecciona el tipo de componente que mejor describe el servicio.

Esto ayuda a clasificarlo correctamente dentro de Backstage.

Si tienes duda, elige la opcion que normalmente use tu equipo para servicios similares.

5. Equipo asociado

Selecciona el equipo responsable del servicio.

Esto permite que el servicio quede asociado al grupo correcto y que las personas adecuadas puedan identificarlo y administrarlo.

Verifica este dato con cuidado, porque es una de las partes mas importantes del registro.

6. Repositorio de GitLab

En esta parte veras dos campos:

  • Owner Available
  • Repository

Debes separar la informacion del repositorio en esas dos partes.

Ejemplo 1

Si tu repositorio es:

https://portal-developers.amxdigital.net/Claro-Chile/cl_ms_fe_bancoestado_backstage

Debes capturarlo asi:

  • Owner Available: Claro-Chile
  • Repository: cl_ms_fe_bancoestado_backstage

Ejemplo 2

Si tu repositorio es:

https://portal-developers.amxdigital.net/amx_dashboarddigital/dd-logmanagement

Debes capturarlo asi:

  • Owner Available: amx_dashboarddigital
  • Repository: dd-logmanagement

Si tambien quieres crear pipeline de CI/CD

Si deseas que el servicio quede con pipeline desde este mismo proceso, llena tambien esta seccion.

7. Quieres crear un pipeline de CI/CD

Marca esta opcion solo si quieres crear el pipeline ahora.

Ten presente lo siguiente:

  • Si el pipeline ya existe, no lo vuelvas a crear.
  • Si no estas seguro, primero confirma con tu equipo.

8. Nombre del repositorio

Aqui debes colocar el nombre real del proyecto dentro de GitLab.

Este valor puede no verse igual que el nombre escrito en la URL.

Ejemplo

Si la URL es:

https://portal-developers.amxdigital.net/amx_dashboarddigital/dd-logmanagement

El valor correcto podria ser:

DD-LogManagement

Si tienes duda, abre el proyecto en GitLab y revisa el nombre mostrado en la parte general.

9. Lenguaje del servicio

Selecciona el lenguaje principal del servicio.

Este dato es importante porque define la configuracion base del pipeline.

Elige con cuidado la opcion correcta para evitar configuraciones equivocadas.

Recomendaciones antes de enviar

Antes de continuar, revisa especialmente estos datos:

  • Proyecto o iniciativa.
  • Nombre del servicio.
  • Equipo asociado.
  • Owner de GitLab.
  • Nombre del repositorio.
  • Nombre del proyecto en GitLab, si vas a crear pipeline.
  • Lenguaje del servicio, si vas a crear pipeline.

Si alguno de estos datos queda mal, el alta puede requerir correcciones despues.

Resultado esperado

Si todo fue llenado correctamente, el servicio quedara registrado y visible en Backstage.

Si tambien elegiste crear pipeline, el flujo de CI/CD quedara generado junto con la configuracion base necesaria para su uso.

Gravitee Api Manager

Introducción

Info

Gravitee es una solución integral para la gestión de API, que ayuda a los desarrolladores a crear, desplegar y monitorear sus API de manera eficiente, proporciona una serie de herramientas para el desarrollo, el despliegue, la seguridad y la monitorización.

Inicio rápido

Gravitee API Manager consta de dos componentes principales para desarrolladores:

  1. Consola de administración proporciona una interfaz web para administrar y configurar las APIs.
  2. Portal para desarrolladores proporciona una interfaz para que los desarrolladores registren, documenten, prueben y monitoreen las APIs.

Ambos componentes trabajan juntos para ofrecer una experiencia completa y fácil de usar para desarrolladores y administradores de APIs.

Arquitectura general

ArqGravitee ArqGravitee

Console UI:

Es una interfaz web que permite a los administradores configurar y gestionar la plataforma de manera sencilla.

Los desarrolladores pueden realizar varias actividades en la consola de usuario (UI) de Gravitee API Manager, algunas de las principales incluyen:

  • Crear y gestionar APIs: Los desarrolladores pueden crear nuevas APIs y configurar sus detalles, como la autenticación, autorización y políticas de seguridad. También pueden editar y eliminar APIs existentes.
  • Manejo de usuarios y roles: Los desarrolladores pueden crear y gestionar usuarios y roles, asignando diferentes permisos para acceder y utilizar las APIs.
  • Monitoreo y análisis: La consola de usuario proporciona herramientas para monitorear el rendimiento de las APIs, como estadísticas de tráfico y errores, y herramientas para analizar el uso de las APIs.
  • Documentación y soporte: Los desarrolladores pueden crear y publicar documentación para las APIs, incluyendo ejemplos de código y detalles de las solicitudes y respuestas. También pueden proporcionar soporte para los usuarios de las APIs.
  • Gestión de versión: Los desarrolladores pueden manejar versiones de sus API, ya sea cambiando o creando nueva versiones, y asignando diferentes políticas de seguridad.

Alta de API

  1. El registro de un API en Gravitee API Manager se hace a través del menú principal en la izquierda. En la sección de APIs, haga clic en el botón ‘+Agregar API’.

    ArqGravitee ArqGravitee

  2. El asistente de creación de API nos guía a través de varios pasos. Se recomienda seguir las mejores prácticas para REST, disponibles en la guía mejores prácticas.

    2.1 Se selecciona “Continue in the wizard” ArqGravitee ArqGravitee 2.2 Se especifica el nombre, la versión conforme al versionado semántico, una descripción, y un contexto único por cada servicio.
    ArqGravitee ArqGravitee 2.3 Se crea el primer plan con: el nombre del plan, el tipo de seguridad, la descripción del plan, y los recursos que debe involucrar.
    ArqGravitee ArqGravitee 2.4 En caso de contar con el diseño en OpenAPI se puede cargar en este paso, en caso contrario se da click sobre “skip”.
    ArqGravitee ArqGravitee 2.5 Se finaliza el asistente creando e iniciando la api.
    ArqGravitee ArqGravitee

  3. Consola de administración general de API ArqGravitee ArqGravitee

Portal de desarrolladores:

Es una interfaz web que permite a los desarrolladores registrar sus aplicaciones y solicitar claves de API.

  • Los desarrolladores pueden realizar varias actividades en el portal para desarrolladores de Gravitee API Manager, algunas de las principales incluyen:
  • Registro y obtención de claves de acceso: Los desarrolladores pueden registrarse en el portal y solicitar claves de acceso para utilizar las APIs.
  • Documentación y soporte: El portal proporciona documentación detallada y ejemplos de código para ayudar a los desarrolladores a utilizar las APIs. También proporciona una sección de soporte para que los desarrolladores puedan hacer preguntas y obtener ayuda.
  • Pruebas de APIs: El portal permite a los desarrolladores probar las APIs antes de implementarlas en sus aplicaciones, ya sea a través de una consola interactiva o mediante una herramienta de prueba automatizada.
  • Monitoreo y análisis: Los desarrolladores pueden monitorear el rendimiento de las APIs y analizar su uso, mediante las estadísticas y gráficos proporcionados en el portal.
  • Analítica de datos: El portal proporciona analítica de datos de las APIs, para ayudar a los desarrolladores a entender como los usuarios utilizan las APIs y para mejorar la experiencia de usuario.
  • Gestión de versión: Los desarrolladores pueden obtener acceso a diferentes versiones de las APIs y también pueden verificar cambios en las versiones.

Alta de aplicación

En Gravitee API Manager, una API se compone de varios elementos básicos, algunos de los cuales incluyen:

  1. Endpoints: Un endpoint es un punto de acceso de una API que se utiliza para recibir y responder a las solicitudes de los clientes.
  2. Plan de precios: Un plan de precios es un conjunto de reglas que especifican el número de solicitudes permitidas, el ancho de banda, el almacenamiento y otros límites de uso.
  3. Autenticación y autorización: Una API puede requerir autenticación y autorización para garantizar que solo los usuarios autorizados puedan acceder a ella.
  4. Documentación: Una API debe proporcionar documentación detallada sobre cómo usarla, incluyendo ejemplos de código y descripciones de los parámetros de entrada y salida.

Api Gateway:

Es el componente principal de Gravitee que se encarga de recibir las solicitudes de las API y de aplicar las políticas de seguridad y autenticación configuradas.

Management API:

Es una API que permite a gravitee gestionar y configurar la plataforma.

Ligas de referencia

Procedimiento de solicitud de modificación de API-Manager

  1. El usuario genera el ticket en OTRS utilizando el siguiente formato: [05.RFC - Modificación de componentes de infraestructura (modificación a los componentes ya instalados).]

  2. El equipo de Infraestructura Analizará la información proporcionada y:
    1. Solicita al remitente la información faltante
    2. o
    3. Solicita el VoBo o Autorización del jefe inmediato o de algún superior facultado.

  3. El usuario responde:
    1. Con la información restante reiniciando en el punto 2
    2. o
    3. Adjunta evidencia de VoBo o autorización que impida el repudio posterior del jefe inmediato o algún superior facultado

  4. El equipo de infraestructura atiende enviando evidencia de la ejecución.

  5. El usuario valida la correcta ejecución o contesta indicando el error.

Guía de actualización MySQL 5.7 a 8.0

Warning

El ciclo de vida de MySQL 5.7 terminó el 21 de Octubre de 2023. A fin de mantener soporte y actualizaciones de seguridad todas las instancias que tengan este motorbases de datos con esta versión deben de ser actualizados.

Info

Antes de realizar un upgrade a MySQL 8, tanto los usuarios como los desarrolladores deben considerar una serie de aspectos importantes para garantizar una transición fluida y minimizar posibles problemas. Algunas consideraciones clave son:

Para Usuarios Finales:

  1. Compatibilidad de Aplicaciones: Verificar que todas las aplicaciones y herramientas que dependen de MySQL sean compatibles con la versión 8. Algunas características o cambios pueden romper la compatibilidad con versiones anteriores.

  2. Pruebas en un Entorno de Desarrollo: Realizar pruebas exhaustivas de las aplicaciones en un entorno de desarrollo que simule las condiciones del entorno de producción. Esto ayudará a identificar posibles problemas de compatibilidad o funcionalidad antes de realizar la actualización en producción.

  3. Documentación: Revisar la documentación oficial de MySQL 8 para comprender las nuevas características, cambios y consideraciones de migración.
    https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-sql-changes

Para Desarrolladores:

  1. Compatibilidad de Consultas: Revisar y actualizar consultas SQL para garantizar que sean compatibles con MySQL 8. Algunas características o sintaxis pueden haber cambiado o mejorado en la nueva versión.

  2. Manejo de Errores y Excepciones: Reforzar el manejo de errores y excepciones en las aplicaciones para anticipar posibles cambios en el comportamiento de MySQL 8 y garantizar una respuesta adecuada a situaciones inesperadas.

  3. Optimización de Consultas: Aprovechar las nuevas características de optimización de consultas introducidas en MySQL 8 para mejorar el rendimiento de las aplicaciones y consultas SQL existentes.

  4. Seguridad y Privilegios: Revisar y actualizar los mecanismos de seguridad y control de acceso para aprovechar las mejoras de seguridad introducidas en MySQL 8, como la autenticación basada en roles y el plugin de Autenticación. *Los usuarios deberan ser recreados para que use dicho plugin de autenticación.
    https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password-compatible-connectors
    https://dev.mysql.com/downloads/connector/cpp/

  5. Validación de compatibilidad de clientes: Es fundamental verificar la compatibilidad de los drivers del cliente, que se están utilizando, sean compatibles con MySQL 8. Esta revisión es necesaria para garantizar un funcionamiento óptimo y sin problemas del sistema.
    https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password-compatible-connectors
    https://dev.mysql.com/downloads/connector/cpp/

  6. Pruebas Unitarias y de Integración: Realizar pruebas exhaustivas de todas las funcionalidades de la aplicación, incluyendo pruebas unitarias y de integración, para verificar que todo funcione correctamente en MySQL 8.

  7. Documentación: Revisar la documentación oficial de MySQL 8 para comprender las nuevas características, cambios y consideraciones de migración.

https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-sql-changes