Este repositorio contiene un script de Python que permite ejecutar escaneos de seguridad usando la API de Titvo. Está diseñado para integrarse con GitHub y realizar análisis de seguridad sobre repositorios específicos.

La acción realiza las siguientes operaciones:

• Inicia un escaneo de seguridad en un repositorio de GitHub
• Consulta periódicamente el estado del escaneo hasta que se complete
• Reporta el resultado del escaneo (éxito o fallo)
• En caso de fallo, proporciona la URL del issue creado

• Python 3.x
• Acceso a la API de Titvo (clave de API)
• Token de GitHub con permisos adecuados

python main.py <titvo_api_endpoint> <titvo_api_key> <github_token> <github_repo_name> <github_commit_sha> <github_assignee> <github_branch>

• titvo_api_endpoint: URL base de la API de Titvo (por ejemplo https://api.ejemplo.com). El script concatena las rutas /run-scan y /scan-status a esta URL
• titvo_api_key: Clave de API para autenticarse con el servicio de Titvo
• github_token: Token de acceso a GitHub para acceder al repositorio
• github_repo_name: Nombre del repositorio de GitHub a escanear (formato: usuario/repositorio)
• github_commit_sha: Hash SHA del commit a analizar
• github_assignee: Usuario de GitHub al que se asignarán los issues en caso de encontrar problemas
• github_branch: Nombre de la rama (branch) a escanear
• scan_mode: Indica si el escaneo debe ser completo (full) o por commit (commit). Por defecto es commit.

1. El script inicia una solicitud de escaneo a la API de Titvo
2. Recibe un ID de escaneo
3. Consulta el estado del escaneo cada 60 segundos hasta que se complete o falle
4. Registra el tiempo total de ejecución
5. Muestra el resultado final del escaneo

name: Titvo Security Scan

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  security-scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Set up Python
        uses: actions/setup-python@v2
        with:
          python-version: '3.x'
          
      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install requests
          
      - name: Run Titvo Security Scan
        run: |
          python main.py "${{ vars.TITVO_API_ENDPOINT }}" "${{ secrets.TITVO_API_KEY }}" "${{ secrets.GITHUB_TOKEN }}" "${{ github.repository }}" "${{ github.sha }}" "${{ github.actor }}" "${{ github.ref_name }}" "full"

Sustituye vars.TITVO_API_ENDPOINT por la variable o secreto donde guardes la URL base de la API, o un valor literal acorde a tu entorno Titvo.

Si usas esta acción con uses:, pasa el endpoint con el input titvo_api_endpoint (primer argumento que recibe el contenedor):

- uses: ./
  with:
    titvo_api_endpoint: ${{ vars.TITVO_API_ENDPOINT }}
    titvo_api_key: ${{ secrets.TITVO_API_KEY }}
    github_token: ${{ secrets.GITHUB_TOKEN }}
    github_repo_name: ${{ github.repository }}
    github_commit_sha: ${{ github.sha }}
    github_assignee: ${{ github.actor }}
    github_branch: ${{ github.ref_name }}
    scan_mode: full

Este proyecto está bajo la licencia Apache 2.0. Consulte el archivo LICENSE para más detalles.