Instalação

É possível instalar o Horusec-CLI de 4 maneiras:

1. Instalação Local
2. Instalação Manual
3. Instalação via Imagem Docker
4. Instalação via Pipeline

A seguir, você irá entender melhor cada uma delas.

Requisitos

Para usar é obrigatório algumas ferramentas instaladas em sua máquina:

• Docker
  Para desabilitar o docker, veja como usar o Horusec sem o Docker, mas você perderá as análises por outras ferramentas.
• Git
  Para rodar análise com git, veja como habilitar análise no histórico git, mas não é habilitado por padrão.

Instalação Local

A instalação feita direto no seu computador é ideal para quem quer usar logo o Horusec, seja fazer análises ou verificar as vulnerabilidades de um projeto.

Confira, a seguir, o comando necessário para instalar o Horusec localmente de acordo com o sistema operacional:

MAC ou Linux

Para instalar o Horusec nos sistemas MacOS ou Linux, basta rodar o comando abaixo no seu terminal:

curl -fsSL https://horusec.io/bin/install.sh | bash

Windows

Para instalar o Horusec-CLI no Windows, basta rodar o comando abaixo no seu terminal:

curl "https://horusec.io/bin/latest/win_x64/horusec.exe" -o "./horusec.exe" && ./horusec.exe version

Instalação Manual

A instalação manual é feita de acordo com o sistema operacional e a versão que deseja fazer download.

Os links abaixo abaixo um dos links para realizar download da última versão.

• Windows x64:

  • 📥 https://horusec.io/bin/latest/win_x64/horusec.exe

• Windows x64:

  • 📥 https://horusec.io/bin/latest/win_x64/horusec.exe

• Windows x86:

  • 📥 https://horusec.io/bin/latest/win_x86/horusec.exe

• Linux x64:

  • 📥 https://horusec.io/bin/latest/linux_x64/horusec

• Linux x86:

  • 📥 https://horusec.io/bin/latest/linux_x86/horusec

• Mac x64:

  • 📥 https://horusec.io/bin/latest/mac_x64/horusec

👉A última versão disponível

👉Todas as versões disponíveis

Instalação via Imagem Docker

Esta forma de instalação permite que você realize suas análises por meio de uma imagem docker, que você roda localmente ou utilizando sua pipeline.

Veja alguns casos de uso:

Iniciando imagem com comando run:

Quando você inicializa a imagem com o comando run, basta executar o Horusec com o comando que você deseja:

docker run -v /var/run/docker.sock:/var/run/docker.sock -v $(pwd):/src horuszup/horusec-cli:latest horusec start -p /src -P $(pwd)

Instalação via Pipeline

Este tipo de instalação garante que a entrega do seu projeto em produção seja segura, já que o Horusec é adicionado à sua pipeline.

Veja a seguir as formas de instalação considerando diferentes tipos de pipeline:

Github Actions

name: SecurityPipeline

on: [push]

jobs:
  horusec-security:
    name: horusec-security
    runs-on: ubuntu-latest
    steps:
    - name: Check out code
      uses: actions/checkout@v2
    - name: Running Horusec Security
      run: |
        curl -fsSL https://horusec.io/bin/install.sh | bash
        horusec start -p="./" -e="true"        

AWS Code Build

• Environment:

  • Imagem de ambiente: Imagem gerenciada
  • Sistema operational: Ubuntu
  • Tempo(s) de execução: Standard
  • Imagem: aws/codebuild/standard:3.0
  • Versão de imagem: Latest
  • Tipo de ambiente: Linux
  • Habilite esse indicador se quiser criar imagens do Docker ou quiser que suas compilações obtenham privilégios elevados: true

• Buildspec:

version: 0.2

phases:
  install:
    runtime-versions:
      docker: 18
  build:
    commands:
      - docker run -v /var/run/docker.sock:/var/run/docker.sock -v $(pwd):/src/horusec horuszup/horusec-cli:latest horusec start -p /src/horusec -P $(pwd)

Circle CI

version: 2.1

executors:
  horusec-executor:
    machine:
      image: ubuntu-1604:202004-01

jobs:
  horusec:
    executor: horusec-executor
    steps:
      - checkout
      - run:
          name: Horusec Security Test
          command: |
            curl -fsSL https://horusec.io/bin/install.sh | bash
            horusec start -p="./" -e="true"            
workflows:
  pipeline:
    jobs:
      - horusec

Jenkins

stages {
        stage('Security') {
            agent {
                docker { image 'docker:dind' }
            }
            steps {
                sh 'curl -fsSL https://horusec.io/bin/install.sh | bash'
                sh 'horusec start -p="./" -e="true"'
            }
        }
    }

Azure DevOps Pipeline

pool:
  vmImage: 'ubuntu-18.04'

steps:
- script: curl -fsSL https://horusec.io/bin/install.sh | bash && horusec start -p ./

GitLab CI/CD

image: docker:latest

services:
  - docker:dind

build-code-job:
  stage: build
  script:
    - docker run -v /var/run/docker.sock:/var/run/docker.sock -v $(pwd):/src/horusec horuszup/horusec-cli:latest horusec start -p /src/horusec -P $(pwd)

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.