Guía pública

Ingiere tus primeros hallazgos

Ejecute su primer escaneo, envíe hallazgos y confirme la calidad de los datos antes de expandirse a más integraciones. Audiencia: Ingenieros de seguridad, propietarios de CI e ingenieros de integración. Tiempo típico de configuración: 10-15 minutos.

Empieza aquíjourney

Úsalo si

Ejecute su primer escaneo, envíe hallazgos y confirme la calidad de los datos antes de expandirse a más integraciones.

Audience: Ingenieros de seguridad, propietarios de CI e ingenieros de integraciónTypical time: 10-15 minutos

Empieza aquí

Step 5 of 7

Recomendado
1
2
3
4
5
6
7

Antes de comenzar

  • Cree una clave API de ingesta en /api-keys y guarde la clave sin formato (se muestra una vez).
  • Use imagen del escáner public.ecr.aws/blackshield-security/pipeline-scanner:1.0.14 (o su alias public.ecr.aws reflejado).
  • Establezca BLACKSHIELD_API_URL en su punto final de backend (local: http://localhost:8000).

Haz esto ahora

1

Paso 1

Elija la imagen del escáner y el primer destino

Uuse un objetivo determinista y una imagen de escáner conocida para que los resultados sean fáciles de validar.

  • Use `public.ecr.aws/blackshield-security/pipeline-scanner:1.0.14` (o su alias de ECR público reflejado) por primera vez ejecutar.
  • Elija un objetivo conocido, como `python:3.11-slim` para obtener primeros resultados predecibles.
  • Ejecute Trivy para el primer escaneo predeterminado; use Semgrep solo con reglas locales o propias del cliente.
  • Mantenga metadatos de rama, confirmación o artefacto para solucionar problemas.

Cómo se ve el éxito

Mantenga metadatos de rama, confirmación o artefacto para solucionar problemas.

Deploy the Pipeline Scanner
2

Paso 2

Cree y use una API de ingesta clave

Cree una clave de espacio de trabajo en Claves API y úsela solo para la ingesta del escáner.

  • Obra `/api-keys`, cree una clave y guarde el valor sin procesar `sp_...` inmediatamente.
  • Establezca `BLACKSHIELD_API_URL` y `BLACKSHIELD_API_KEY` a través de variables de entorno.
  • Ejecute el contenedor o el punto de entrada del cliente del escáner coincidente command.
  • Capture registros de respuesta como prueba de cargas útiles aceptadas.

Cómo se ve el éxito

Capture registros de respuesta como prueba de cargas útiles aceptadas.

Claves de API abiertas · Requiere inicio de sesión
3

Paso 3

Validar la calidad y la deduplicación

Ensure que los hallazgos estén completos, la gravedad esté asignada correctamente y las cargas repetidas no se dupliquen issues.

  • Oabrir hallazgos y filtrar por escáner y recurso.
  • Verifique que los campos `first_seen` y `last_seen` estén completos.
  • Reenvíe la misma carga útil una vez y verifique el comportamiento de deduplicación.

Cómo se ve el éxito

Reenvíe la misma carga útil una vez y verifique el comportamiento de deduplicación.

Oabrir hallazgos · Requiere inicio de sesión

Solo demostración

Esta configuración está diseñada para facilitar el uso. Para desplegar clientes de escaneo a escala, planifique su arquitectura de despliegue en consecuencia o contáctenos para obtener las mejores prácticas empresariales.

Ejecuta esto

Cree una clave API de ingesta a través de API
TOKEN=$(curl -s -X POST "http://localhost:8000/api/v1/auth/login?email=admin@acme.com&password=changeme123" | python3 -c "import sys, json; print(json.load(sys.stdin)['access_token'])")

curl -s -X POST http://localhost:8000/api/v1/api-keys \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"label":"Pipeline Scanner","expires_in_days":90}'
Ejecute el primer análisis de canalización e incorpore los hallazgos
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e BLACKSHIELD_API_URL=http://localhost:8000 \
  -e BLACKSHIELD_API_KEY=sp_your_key_here \
  -e SCAN_TOOL=trivy \
  -e SCAN_TARGET=python:3.11-slim \
  public.ecr.aws/blackshield-security/pipeline-scanner:1.0.14

Cómo se ve el éxito

  • El estado del trabajo de ingestión llega a completado con creado > 0 o actualizado > 0.
  • Aparecen nuevos hallazgos en /findings con gravedad, análisis de origen y marcas de tiempo.

Continúa

Keep your rollout moving with the next recommended step.

Revisa y prioriza hallazgos
Ingiere tus primeros hallazgos | Docs de BlackShield