Descobriments Docker

Els descobriments Docker permeten llistar un conjunt d’imatges Docker a partir d’un registre o d’un desplegament existent. Després, les imatges Docker descobertes es poden afegir a Cyberwatch amb una acció en bloc perquè s’escanegin.

JFrog Artifactory

Requisits previs

Els descobriments JFrog Artifactory requereixen:

• Un compte de servei de JFrog (usuari dedicat, no administrador)
• Un permís de lectura (Read) concedit a aquest compte sobre els repositoris Docker que s’han de descobrir
• Un testimoni d’accés generat per a aquest compte

JFrog Artifactory exposa els seus repositoris Docker en forma de registres. El descobriment JFrog Artifactory consulta l’API de JFrog per llistar les imatges Docker accessibles, que després Cyberwatch podrà escanejar. N’hi ha prou amb un accés de lectura als repositoris Docker corresponents: per tant, es recomana dedicar a Cyberwatch un compte de servei amb drets mínims.

Crear un compte de servei i un testimoni a JFrog

Podeu crear aquest compte de servei de la manera següent:

1. Creeu l’usuari: des de Administration > User Management > Users, creeu un usuari de servei no administrador (per exemple cyberwatch).
2. Concediu els drets de lectura: des de Administration > User Management > Permissions, creeu un permís que només doni l’acció Read sobre els repositoris Docker que s’han de descobrir, i associeu-hi aquest compte (o un grup que el contingui).
3. Genereu el testimoni d’accés: des de Administration > User Management > Access Tokens, creeu un Scoped Token per a aquest compte establint Token scope a User, perquè el testimoni hereti només els permisos del compte. Conserveu el nom d’usuari i el testimoni generat: els necessitareu al pas següent.

Desar la credencial a Cyberwatch

Des del menú Credencials desades, podeu afegir una credencial del tipus JFrog Artifactory indicant l’URL de la vostra plataforma JFrog, el nom d’usuari del compte de servei i el testimoni d’accés generat anteriorment.

Crear el descobriment

Després podreu crear el descobriment des del menú Descobriments fent clic al botó Afegeix i després a JFrog Artifactory a la secció Imatges Docker, i triant el vostre joc de credencials. Si l’accés està ben configurat, el descobriment llistarà totes les imatges Docker trobades.

Afegir les imatges Docker descobertes

Des de la llista d’actius descoberts, podreu veure i filtrar les imatges que no tenen actius associats. Per afegir-les a Cyberwatch, podeu seleccionar les que vulgueu escanejar i fer clic a Accions en bloc > Escaneja com a imatges Docker.

L’addició a Cyberwatch de les imatges Docker descobertes recentment es pot automatitzar activant el registre automàtic des del formulari d’edició del descobriment.

El registre es tria automàticament a partir del nom de la imatge descoberta. Per exemple, una imatge example.com/library/hello utilitzarà automàticament el registre Docker example.com, sempre que s’hagi afegit com a credencial desada. Si el registre és nou, es crearà automàticament una credencial desada, que després es podrà editar manualment si cal autenticació. De vegades es pot indicar un registre preferent, però només s’utilitzarà per a les imatges descobertes en què el registre que figura al nom coincideixi amb el punt d’entrada del registre.