> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corgea.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Subir escaneos

> Empieza a generar correcciones para tu repositorio

Puedes utilizar Corgea Dropsite o la CLI de Corgea.

<Info>
  **Requisito previo**: Te has registrado en Corgea.

  **Escáner SAST**: Utilizas Checkmarx, CodeQL, Semgrep, Fortify, Coverity o Snyk. Corgea admite actualmente estos escáneres; está previsto añadir compatibilidad con Veracode y SonarQube.
</Info>

## Corgea Dropsite

Corgea Dropsite es una interfaz web para añadir proyectos y analizarlos en Corgea. Ofrece varias formas de subir código e informes de distintos escáneres de seguridad. El tamaño máximo de archivo es de 200 MB; utiliza la CLI de Corgea para proyectos mayores.

### Añadir un proyecto

Para añadir un proyecto a Corgea, sigue estos pasos:
Accede a la página de Dropsite haciendo clic en el botón "Añadir proyecto" en la página de Proyectos Corgea o en la página de Escaneos.

<Frame>
  <img src="https://mintcdn.com/corgea/uxLuQR4653lM43Tj/images/add_project.png?fit=max&auto=format&n=uxLuQR4653lM43Tj&q=85&s=a5c3236d7c3b96e8dd8098a04db3d612" style={{ borderRadius: '0.5rem' }} width="1098" height="730" data-path="images/add_project.png" />
</Frame>

En la página de Dropsite verás varias opciones para añadir tu proyecto:

<Frame>
  <img src="https://mintcdn.com/corgea/uxLuQR4653lM43Tj/images/dropsite_add_project.png?fit=max&auto=format&n=uxLuQR4653lM43Tj&q=85&s=9485d69a1856ecf518b80b3e0514e4c9" style={{ borderRadius: '0.5rem' }} width="2434" height="1380" data-path="images/dropsite_add_project.png" />
</Frame>

#### Conecta tu repositorio (recomendado)

Esta opción te permite conectar tu repositorio de código directamente a Corgea mediante una integración de control de versiones configurada, incluyendo GitHub, GitLab, Azure DevOps, Bitbucket o Harness.
Haz clic en la integración de control de versiones correspondiente para autorizar a Corgea a acceder a tus repositorios.
Selecciona el repositorio que quieres añadir a Corgea.

#### Añadir un repositorio público

Si tu repositorio es accesible públicamente, puedes proporcionar la URL para añadirlo a Corgea.
Haz clic en el acordeón "Añadir un repositorio público".
Introduce la URL del repositorio público en el campo correspondiente.
Haz clic en el botón "Añadir".

#### Subida web

Esta opción te permite subir un archivo ZIP que contenga el código de tu proyecto.
Haz clic en el acordeón "Subida web".
Haz clic en el botón "Subir" y selecciona el archivo ZIP que contiene el código de tu proyecto.

<Tip>
  Para reducir el tamaño del archivo y acelerar el procesamiento, excluye las bibliotecas de terceros y los artefactos de compilación, como node\_modules, vendor o dist. Puedes hacerlo descargando el ZIP directamente desde el repositorio.
</Tip>

<Warning>
  La subida web admite archivos de hasta 200 MB. Para proyectos mayores, utiliza la CLI de Corgea.
</Warning>

Después de añadir tu proyecto, puedes pasar al siguiente paso para subir un informe desde un escáner de seguridad compatible.

#### Subir un informe

<Frame>
  <img src="https://mintcdn.com/corgea/mpJUc1GyXtnVYEyT/images/upload_report.png?fit=max&auto=format&n=mpJUc1GyXtnVYEyT&q=85&s=ac858a4bdf28e8cc2e46552db583208a" style={{ borderRadius: '0.5rem' }} width="2512" height="2040" data-path="images/upload_report.png" />
</Frame>

<Steps>
  <Step title="Sube el informe">
    Selecciona el archivo de informe (normalmente un archivo JSON) de tu máquina local y suéltalo en el cuadro de subida.
    <Info>Corgea admite informes de Checkmarx (JSON), CodeQL (JSON), Snyk (SARIF), Semgrep (JSON), Fortify (FPR) y Coverity (XML).</Info>
  </Step>

  <Step title="Procesamiento">
    Cuando termine la subida, Corgea procesará el proyecto y el informe.
  </Step>

  <Step title="Ver resultados">
    Serás redirigido al panel de control de Corgea, donde podrás ver los resultados del análisis de tu proyecto.
  </Step>
</Steps>

Siguiendo estos pasos, puedes añadir fácilmente tu proyecto y subir informes de seguridad a Corgea para su análisis y remediación.

### Corgea CLI

La CLI de Corgea (interfaz de línea de comandos) ofrece funciones avanzadas para integrar Corgea con tu pipeline CI/CD, realizar escaneos personalizados y subir grandes proyectos (>200MB).
Abre "Corgea CLI" para obtener información sobre cómo instalar y utilizar la [CLI](install_cli).

Puedes instalar la CLI de Corgea usando pip:

```bash theme={null}
pip install corgea-cli
```

[Más información sobre la CLI](install_cli)

#### Sube con la CLI

<Steps>
  <Step title="Ir al repositorio">
    Ve al repositorio que quieres escanear:

    <CodeGroup>
      ```bash Bash theme={null}
      cd <<Respository Name>>
      ```
    </CodeGroup>
  </Step>

  <Step title="Haz el escaneo">
    <CodeGroup>
      ```bash Semgrep theme={null}
      corgea scan semgrep
      ```

      ```bash Snyk theme={null}
      corgea scan snyk
      ```

      ```bash Custom project name theme={null}
      corgea upload report.json --project-name my-service
      ```

      ```bash Checkmarx theme={null}
      # Create a scan with a JSON output for example:
      cx scan create --project-name juice-shop -s . --branch master --scan-types sast --report-format json --output-name report

      #Upload the vulnerability report to Corgea
      corgea upload report.json
      ```

      ```bash CodeQL theme={null}
      corgea upload <scan report in json>
      ```

      ```bash Fortify theme={null}
      corgea upload <scan report in FPR>
      ```

      ```bash Coverity theme={null}
      corgea upload <scan report in XML>
      ```
    </CodeGroup>
  </Step>

  <Step title="Ver resultados">
    Una vez completado el escaneo, se generará un informe de escaneo en la carpeta del repositorio y se enviará una copia a Corgea para su procesamiento.

    <Frame>
      <img src="https://mintcdn.com/corgea/uxLuQR4653lM43Tj/images/completed-scan.png?fit=max&auto=format&n=uxLuQR4653lM43Tj&q=85&s=5e7ee36166bd94cddeb3f918c2bc53bc" style={{ borderRadius: '0.5rem' }} width="1194" height="205" data-path="images/completed-scan.png" />
    </Frame>
  </Step>

  <Step title="Correcciones de problemas">
    Dependiendo del tamaño de los resultados en el escaneo, puede tardar un tiempo en aparecer. Para un par de cientos de hallazgos, debería tardar 10 minutos.

    Ir a [Correcciones](fixes) para saber más.
  </Step>
</Steps>

## Resolución de problemas

<AccordionGroup>
  <Accordion title="Comando no encontrado">
    Este error ocurre porque no has instalado la CLI de Corega o no está disponible en tu PATH.

    ```
    bash: corgea: command not found
    ```

    Sigue las instrucciones en el [instalar sección CLI](http://localhost:3001/install_cli) para instalar la CLI.
  </Accordion>

  <Accordion title="Token inválido proporcionado.">
    Comprueba dos veces que has iniciado sesión en la CLI con el token correcto de [https://www.corgea.app/integrations/](https://www.corgea.app/integrations/)
  </Accordion>

  <Accordion title="No iniciado sesión">
    Puede que recibas un error diciendo que no has iniciado sesión en tu herramienta SAST/SCA.

    Algunas herramientas requieren que inicies sesión para poder usar la herramienta. Por ejemplo, puedes iniciar sesión en Semgrep con el siguiente comando:

    ```
      semgrep login
    ```
  </Accordion>

  <Accordion title="Git Show no se ejecutó">
    Puede que recibas un error diciendo que no has iniciado sesión en tu herramienta SAST/SCA.

    Algunas herramientas requieren que inicies sesión para poder usar la herramienta. Por ejemplo, puedes iniciar sesión en Semgrep con el siguiente comando:

    ```
      Command failed with output:
      fatal: not a git repository (or any of the parent directories): .git


      Failed to run 'git show -s --format=%B'. Possible reasons:

      - the git binary is not available
      - the current working directory is not a git repository
      - the current working directory is not marked as safe
          (fix with `git config --global --add safe.directory $(pwd)`)

      Try running the command yourself to debug the issue.
      Could not start scan Command failed with exit code: 128
    ```
  </Accordion>
</AccordionGroup>