SAMMY 오픈소스 v2

이 저장소는 OWASP SAMM 도구인 SAMMY의 오픈소스 버전을 호스팅합니다.

https://owasp.org/www-project-open-sammy/

라이선스

이 프로젝트는 크리에이티브 커먼즈 저작자표시-동일조건변경허락 4.0 국제 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

SAMMY v2

• 설정에는 데이터베이스에 미리 정의된 사용자가 포함되어 있습니다:
  • 사용자 이름: [email protected]
  • 비밀번호: admin
  • MFA 키: AB4FHDUHYVGW7IAB (이 키를 인증 앱에 수동으로 추가하세요)

Docker 없이 실행하는 방법

요구 사항

• MySQL 또는 MariaDB
• Redis (APP_ENV=prod에서 실행하려는 경우에만)
• php8.2+
• composer

선택 사항

• Symfony CLI (https://symfony.com/download)

실행 방법

1. 로컬 설정으로 .env.local 파일을 생성하세요. MariaDB 예시:
   • 다른 DB를 사용하는 경우 올바른 연결 문자열은 여기에서 찾을 수 있습니다 - https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html#connecting-using-a-url

DATABASE_URL=mysql://root:[email protected]:3306/sammy?serverVersion=11.3.2-MariaDB
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
APP_ENV=dev
APP_DEBUG=1

2. 설치 및 실행

composer install
./scripts/setup_database.sh
# if you have symfony cli
symfony server:start --allow-http
# else
php -S 0.0.0.0:8000 -t ./public
open http://127.0.0.1:8000

Docker로 실행하는 방법

# 1. start DB and Redis
docker compose up -d db redis
# 2. now we can start our application
docker compose up -d --build app
# 3. sync SAMM model. Note, this step syncs the SAMM model from the core GitHub repo. You only have to run this the very first time and upon every SAMM model update.
docker compose exec app ./scripts/sync_samm.sh
# 4. sync DSOMM model. Note, this step syncs the DSOMM model from the core GitHub repo. You only have to run this the very first time and upon every DSOMM model update.
docker compose exec app ./scripts/sync_dsomm.sh
# 5. Enjoy
open http://127.0.0.1:8000

메일 발송

• 메일 발송 기능을 사용하려면 다음을 .env.local 또는 compose.yaml 파일에 추가해야 합니다. 모든 필드는 필수입니다. 또한 서버는 기본적으로 적절한 SSL을 사용해야 합니다.
  • .env.lcoal의 경우:
    root@kitploit:~

      PHPMAILER_SMTP_HOST=
      PHPMAILER_SMTP_PORT=
      PHPMAILER_SMTP_USERNAME=
      PHPMAILER_SMTP_PASSWORD=
      PHPMAILER_SMTP_DEFAULT_SENDER=
      PHPMAILER_SMTP_USE_AUTH=
      PHPMAILER_SMTP_DEFAULT_ENCRYPTION=
      PHPMAILER_SMTP_AUTO_TLS=
    

    • compose.yaml의 app 섹션 아래 environment 하위의 경우
    root@kitploit:~

    - PHPMAILER_SMTP_HOST=
    - PHPMAILER_SMTP_PORT=
    - PHPMAILER_SMTP_USERNAME=
    - PHPMAILER_SMTP_PASSWORD=
    - PHPMAILER_SMTP_DEFAULT_SENDER=
    - PHPMAILER_SMTP_USE_AUTH=
    - PHPMAILER_SMTP_DEFAULT_ENCRYPTION=
    

• Docker를 사용하는 경우 추가로 할 일은 없습니다. 2분마다 실행되는 크론잡이 있습니다.
• 로컬에서 실행하는 경우 다음 명령을 수동으로 실행해야 합니다:

php ./bin/console app:process-mailing

DSOMM 지원

우리는 DSOMM 모델에 대한 평가를 지원합니다. 기본적으로 필요한 항목이 포함된 DSOMM 모델이 데이터베이스에 있습니다. 원한다면 사용자 정의 DSOMM 변형을 가져올 수 있습니다. 예를 들어 도메인과 프랙티스가 더 많거나 적은 모델을 가질 수 있습니다. 여러 DSOMM 변형을 동시에 가질 수도 있습니다.

php ./bin/console app:sync-from-dsomm --source="path/to/dsomm-file.yaml"

선택적으로 기존 DSOMM 변형에 업데이트를 수행하려면 메타모델 ID를 전달할 수 있습니다.

php ./bin/console app:sync-from-dsomm --source="path/to/dsomm-file.yaml" --metamodel=33

아래와 같은 전체 데이터 구조를 가진 단일 YAML 파일이 필요합니다. 기본적으로 다음 파일을 사용합니다. https://github.com/devsecopsmaturitymodel/DevSecOps-MaturityModel-data/blob/main/src/assets/YAML/generated/generated.yaml