Este artículo explica cómo configurar el conector de GitHub para la política Protección de API de Aplicaciones & Datos para su cuenta y crear reglas que utilicen este conector en la Política de Protección contra Amenazas y Protección de Datos.
La política Protección de API de Aplicaciones & Datos requiere una licencia Cato separada. Por favor, contacte a su representante de Cato o revendedor oficial para más información.
Los archivos binarios no son compatibles con el conector de GitHub.
El conector API de Protección de Datos de GitHub monitorea el contenido en los commits que los usuarios envían a los repositorios, y busca datos sensibles que usted define en los Perfiles de Contenido DLP. Cuando el conector identifica datos sensibles en un commit, genera un evento con los detalles. Por ejemplo, puede buscar tokens API, claves SSH, credenciales de base de datos, y más en los commits.
Para monitorear el contenido en los commits, cree el conector para la organización GitHub, luego configure reglas en las políticas de Protección contra Amenazas y Protección de Datos que definan los usuarios y repositorios que se escanean y monitorean.
Esta sección explica cómo crear conectores API para GitHub para escanear commits en busca de datos sensibles y amenazas.
Utilice la Aplicación de Gestión de Cato para crear el conector GitHub, y luego inicie sesión en su cuenta GitHub. Seleccione la organización en la que instalar el conector, y luego seleccione los repositorios a los que el conector puede acceder. Puede seleccionar todos los repositorios para la organización o solo algunos específicos.
Puede crear un solo conector para cada organización GitHub. Para múltiples organizaciones, se requiere un conector separado para cada una.
El conector de GitHub permite al motor de API de Protección de Datos escanear el contenido que usted define en la política de Protección de Datos.
Nota
Nota:
-
No puede instalar más de un conector para una organización. Intentar instalar un segundo conector para la misma organización puede afectar la funcionalidad, y es posible que la organización ya no sea monitoreada.
-
Cambiar la configuración de un conector existente en la consola de gestión de GitHub puede afectar la funcionalidad, y es posible que la organización ya no sea monitoreada.
Para crear el conector para GitHub:
-
Desde el menú de navegación, selecciona Recursos > Integraciones y haz clic en la pestaña APIs Integradas.
-
Haga clic en Nuevo. El panel Nuevo Conector se abre.
-
En el Conector de aplicación desplegable, selecciona GitHub.
-
En la sección Capacidad, selecciona Protección de Datos y Amenazas.
-
Ingrese el Nombre del Conector.
-
Haga clic en Autorizar y Guardar. Usted es redirigido a GitHub.
-
Instale la aplicación en GitHub:
-
En GitHub, inicie sesión como administrador. Si ya está conectado a GitHub, verifique que está conectado como administrador.
-
Seleccione la organización para el conector.
-
Si es necesario, inicie sesión en la organización.
-
Seleccione los repositorios que el conector tiene permiso para acceder, y haga clic en Instalar. Puede seleccionar todos los repositorios en la organización o específicos.
-
La pantalla muestra que usted ha aplicado correctamente los permisos para el arrendatario.
-
El conector de GitHub se crea y se agrega a la pestaña APIs Integradas.
-
La columna Estado en la página de Aplicaciones SaaS Instaladas muestra el estado de la conexión entre su cuenta GitHub y su cuenta Cato. Estas son las explicaciones de los estados:
-
Conectado - Su cuenta está conectada a la cuenta y funcionando correctamente
-
Error de conexión - Problema de conectividad o permisos con el conector de GitHub. Por favor abra un ticket con Soporte.
-
Pendiente de consentimiento del usuario - El conector de GitHub se crea en la página de Configuraciones de Conexión, sin embargo, no se ha autenticado correctamente en GitHub. Puede tomar varios segundos procesar la autenticación, así que si recibe este estado, actualice el navegador.
Esta sección explica cómo usar la política de Protección de Datos para monitorear commits de GitHub en busca de datos sensibles. Cuando un usuario envía un commit a un repositorio, el motor de Protección de Datos analiza el nuevo contenido contenido en el commit para detectar los datos sensibles definidos en los Perfiles de Contenido. El contenido que fue previamente enviado al repositorio no se escanea, solo el nuevo contenido que es diferente en el commit.
Esta sección explica cómo definir la configuración de las reglas de Protección de Datos para escanear commits de GitHub. Cada regla puede definirse con la siguiente configuración:
-
Usuarios - Defina los usuarios de GitHub a monitorear. Seleccione Cualquiera o defina uno o más usuarios específicos.
-
Objetos - Defina qué repositorios de GitHub se escanean. Seleccione Cualquiera o defina uno o más repositorios específicos.
-
Los repositorios disponibles para escanear incluyen aquellos a los que el conector tiene permiso para acceder, según lo definido cuando se creó el conector. Ver más arriba Crear el conector de GitHub.
-
-
Atributos de Archivo - Excluya archivos del escaneo en función del Nombre de Archivo y Tipo de Archivo. Los archivos que cumplen con los atributos definidos no se escanean para contenido sensible.
-
Perfil de Contenido - Perfil de Contenido DLP que define la inspección de contenido DLP
Puede crear o editar Perfiles de Contenido en Seguridad > Perfiles DLP > Perfiles DLP > Perfil de Contenido
-
Acciones - Seleccione si desea generar un evento o enviar una notificación cuando la regla se cumpla
Utilice la página de Protección de Datos para agregar las reglas de aplicación SaaS en su política de Protección de Datos.
Para crear una nueva regla de Protección de Datos para la aplicación GitHub:
-
En el panel de navegación, seleccione Seguridad > Protección de API de Aplicaciones & Datos y seleccione o expanda Protección de Datos.
-
Haga clic en Nuevo. El panel Nueva Regla se abre.
-
En Conector de Aplicación, seleccione la aplicación GitHub.
-
En la General sección, introduzca la configuración para la regla.
-
En Usuarios, defina los usuarios de GitHub que está monitoreando:
-
Cualquiera - Monitorea todos los usuarios de GitHub en la organización (valor predeterminado)
-
Usuario de GitHub - Seleccione los usuarios específicos de la organización para monitorear
-
-
En Objetos, defina los repositorios de GitHub que se escanean. El valor predeterminado es Cualquiera.
-
En Atributos de Archivo, defina los criterios para especificar los archivos que se escanean (la configuración predeterminada es escanear todos los archivos).
-
En Perfil de Contenido, seleccione el Perfil de Contenido DLP para esta regla.
Para más información sobre Perfiles de Contenido DLP, consulte Creación de Perfiles de Contenido DLP.
-
En Acciones, seleccione Monitorear.
-
(Opcional) Configure las opciones de seguimiento para generar Eventos y Enviar Notificaciones.
Para obtener más información sobre notificaciones, consulte el artículo relevante sobre Grupos de Suscripción, Listas de Correo y Integraciones de Alertas en la sección de Alertas.
-
Haz clic en Guardar. La regla se agrega a la Política de Protección de Datos.
El motor de API de Protección de Datos inspecciona los datos secuencialmente, y verifica si coincide con una regla. Si los datos no coinciden con una regla, entonces no se inspeccionan. Las reglas que están en la parte superior de la base de reglas tienen una mayor prioridad y se aplican antes que las reglas más abajo en la base de reglas. Cada tipo de aplicación o conector se aplica solo a los datos una vez.
Mejor Práctica - Para maximizar la eficiencia de su base de reglas, recomendamos que para cada tipo de conector, las reglas para usuarios específicos tengan una mayor prioridad que las reglas que se aplican a Cualquiera usuario.
Por ejemplo, si los datos coinciden con un conector en la regla #2, los datos son inspeccionados por el motor de API de Protección de Datos. El motor no continúa aplicando las reglas #3 y siguientes para el mismo conector. Sin embargo, los datos podrían coincidir con una regla de menor prioridad con un conector diferente.
Puede crear Reglas de Protección contra Amenazas para el conector para escanear archivos y adjuntos en busca de malware y virus usando los motores Anti-Malware y NG Anti-Malware que están habilitados para su cuenta. El motor de API de Protección de Datos escanea el tráfico del conector y aplica las opciones de acción y seguimiento que configure para la regla:
-
Monitorear el tráfico (el bloqueo será soportado pronto)
-
Generar eventos
-
Enviar notificaciones por correo electrónico
Cuando crea una Regla de Protección de API de Aplicaciones y Datos, los motores Anti-Malware que están habilitados para su cuenta (Seguridad > Anti-Malware) realizan escaneos de malware en los archivos que se envían para esa aplicación de conector.
La siguiente captura de pantalla muestra una regla de protección contra amenazas para el conector de OneDrive que escanea los archivos enviados por usuarios Internos o Invitados:
A veces hay un archivo bloqueado por los motores de API de Protección de Datos de Cato que usted sabe que es seguro, y necesita permitirlo en la red. Las excepciones de Anti-Malware en la política de Hash del archivo también se aplican a la Protección de API de Aplicaciones y Datos. Para obtener más información sobre cómo agregar archivos a la política de Hash del archivo, consulta Managing Anti-Malware Exceptions.
La página Inicio > Eventos muestra todos los eventos de API de Protección de Datos para su cuenta. Las herramientas de búsqueda te permiten encontrar e identificar los eventos que contienen los datos relevantes que necesitas.
Los eventos de API de Protección de Datos pueden ser identificados por los siguientes campos:
-
Tipo de evento - Seguridad
-
Sub-Tipo - Protección de datos de API de seguridad SaaS y Seguridad SaaS API Anti-Malware
Puede aprender más sobre el uso de la página de Eventos aquí.
Este es un ejemplo de evento de conector GitHub de API de Seguridad SaaS:
|
Nombre del campo |
Descripción |
|---|---|
|
Actividad de la Aplicación |
Enviar |
|
Nombre del Conector |
Nombre para el conector que está definido para la regla |
|
Tipo de Conector |
Aplicación SaaS que está definida para este conector |
|
Perfil DLP |
Perfil de Contenido DLP que generó este evento |
|
URL Completa |
Enlace a la comparación de diferencias para el commit |
|
Tipos de Datos Coincidentes |
Tipos de Datos en el Perfil de Contenido que coincidieron con la regla |
|
Regla |
Nombre de la regla en la Política de Protección de Datos |
|
Nombre del Objeto |
Nombre del repositorio al que se envió el commit |
|
Tipo de Objeto |
El tipo de objeto escaneado |
|
Propietario |
Dirección de correo electrónico del usuario que envió el commit |
|
Gravedad |
Gravedad definida para la regla |
0 comentarios
Inicie sesión para dejar un comentario.