Pub 보안
Dartastic Pub은 게시하는 모든 패키지에 점수를 매기고, 공개 패키지를 포함해 제공하는 모든 패키지에 조직의 보안 정책을 적용합니다. 이 페이지에서는 점수, 정책, 거부의 의미와 대처 방법을 설명합니다.
Scores 탭
Dartastic Pub에서 각 패키지의 Scores 탭에는 두 가지 점수가 표시됩니다. 버전이 게시되면 Dartastic Pub은 인터넷에 연결되지 않은 독립된 워커에서 패키지의 최신 안정 버전과 최신 사전 릴리스 버전을 분석합니다.
- Pub points: pub.dev에 표시되는 것과 같은 pana의 160점 보고서입니다. 한 항목만 다릅니다. 비공개 코드에는 상용 라이선스가 적합하므로, 라이선스 항목은 종류와 관계없이 실제 라이선스면 통과합니다. 라이선스가 없거나 비어 있거나 자리표시자면 여전히 통과하지 못하며, 탭에 이 항목이 변경되었다고 표시됩니다.
- Security Score: pana가 확인하지 않는 부분에 대한 0~100점 점수와 등급입니다. 각 검사는 무엇을 살펴봤는지, 무엇을 찾았는지, 어떻게 고치는지 보여 줍니다.
분석을 끝내지 못하면(메모리나 시간이 부족했거나 의존성을 해석하지 못한 경우), 탭에 낮은 점수 대신 그 사실과 이유가 표시됩니다.
Security Score의 검사 항목
| 검사 | 점수 | 확인하는 내용 |
|---|---|---|
| Known advisories | 30 | 이 버전과 이 버전이 해석한 모든 패키지에 대한 알려진 보안 권고. |
| Secrets in the archive | 20 | 아카이브에 남은 토큰, 키, 자격 증명 파일. 패키지를 읽을 수 있는 사람은 누구나 어떤 종류가 발견되었는지 볼 수 있고, 위치는 패키지 관리자만 볼 수 있습니다. |
| Review verdict | 10 | 이 버전에 대한 보안 검토의 판정. |
| Binaries and build hooks | 15 | 아카이브 안의 네이티브 바이너리와 빌드 훅. 각각 sha256과 함께 기록됩니다. 검토를 거쳐 허용되면 이 점수를 받습니다. FFI만으로는 감점되지 않습니다. |
| Publisher and provenance | 15 | 패키지를 누가 게시하는지, 그리고 게시자가 바뀌었는지. |
| Same uploader as the last release | 5 | 이 버전을 업로드한 사람이 이전 버전도 업로드했는지. |
| Release age | 5 | 릴리스 후 7일 이상 지났는지. |
- 판단할 근거가 없는 검사는 제외됩니다. 점수는 실행된 검사만으로 환산되고, 탭에 실행되지 않은 검사가 표시됩니다. 통과로 계산되지 않습니다.
- 등급: 90점 이상 A, 80점 이상 B, 70점 이상 C, 60점 이상 D, 60점 미만 F. A와 B는 파란색, C는 노란색, D와 F는 빨간색으로 표시됩니다.
- 격리되거나 차단된 버전은 0점입니다. 관리자는 두 점수를 직접 설정할 수 있으며, 이 경우 탭에 그 사실이 표시되고 계산된 점수는 기록에 남습니다.
- 점수는 무엇을 확인했는지 알려 줄 뿐, 패키지가 안전하다고 보장하지 않습니다.
조직의 보안 정책
조직마다 정책은 하나이며, 관리자가 바꾸지 않으면 Standard 정책입니다. 정책은 새 공개 버전이 얼마나 기다릴지, 그리고 검토에서 플래그가 지정된 버전을 어떻게 처리할지 정합니다.
| 정책 | 새 공개 버전 | 검토에서 플래그가 지정된 버전 |
|---|---|---|
| Monitor완전한 가시성, 작업 중단 없음 | 즉시 제공 | 제공하고 집계 |
| Standard프로덕션 팀을 위한 균형 잡힌 보호 | 3일 대기 | 제공하고 패키지 페이지에 플래그 표시 |
| Strict규제 환경을 위한 최대한의 통제 | 7일 대기, 검토가 진행 중이면 사람의 판단까지 대기 | 제공하지 않음 |
조직의 자체 패키지는 기다리지 않으며 검토를 위해 보류되지도 않습니다. 어떤 정책도 격리되거나 차단된 버전을 제공하지 않습니다.
새 공개 버전은 기다립니다
정책의 기한보다 최근에 나온 공개 버전은 Dartastic Pub이 제공하는 버전에서 제외되므로, dart pub get 명령은 기한을 채운 가장 최신 버전으로 해석됩니다. 실패하는 것은 없습니다. 관리자는 버전을 조기에 승인하거나 반려할 수 있습니다.
lock 파일이 아직 대기 중인 버전을 이미 고정하고 있으면, dart pub get 명령은 그 버전을 거부하고 사용할 수 있게 되는 날짜를 알려 줍니다.
검토와 판정
다음 신호가 있으면 버전이 검토 대상이 됩니다: 인기 패키지와 오타 한 글자 차이인 이름, 게시자가 바뀐 공개 패키지, 오랫동안 잠잠하다가 갑자기 릴리스된 패키지, 자체 패키지에 새로 등장한 업로더. Strict 정책에서는 검토가 진행 중인 동안 버전이 대기합니다.
검토는 판정으로 끝납니다. allow: 버전을 제공합니다. warn: 페이지에 플래그를 표시해 제공합니다(Strict 정책 제외). quarantine, deny: 모든 조직에서 버전을 막습니다.
품질 게이트
조직 관리자는 품질 게이트를 설정할 수 있습니다: 최소 pub points, 최소 Security Score, 반드시 통과해야 하는 검사. 게이트에 못 미치는 버전은 조직에 제공되는 버전에서 제외되므로 dart pub get 명령이 선택할 수 없습니다.
공개 패키지는 여기서 pub points를 받지 않으므로, pub points 최소 기준 때문에 보류되지 않습니다. 필수 검사는 통과해야 하므로, 실행되지 않은 필수 검사는 실패로 처리됩니다.
CI는 읽을 때 쓰는 것과 같은 Pub 토큰으로 버전의 통과 여부를 확인할 수 있습니다. 응답의 status 값은 allow, warn, block, pending 중 하나입니다. pending 상태는 분석이 아직 끝나지 않았다는 뜻이므로, 그동안 계속 폴링하세요:
curl -sS -H "Authorization: Bearer $PUB_TOKEN" \
https://pub.dartastic.io/api/dartastic/security/quality-gate/acme_models/1.3.0{
"package": "acme_models",
"version": "1.3.0",
"status": "block",
"securityScore": 73,
"pubPoints": 140,
"reasons": ["Security Score 73 is below 80."],
"gate": { "action": "block", "minSecurityScore": 80, "minPubPoints": 120, … }
}버전 하나를 게이트에서 통과시키려면 조직 관리자가 사유와 함께 예외로 지정합니다. 그러면 해당 버전에만 게이트가 해제됩니다.
dart pub get이 버전을 거부할 때
거부 메시지는 이유와 해야 할 일을 알려 줍니다. 각 메시지의 의미는 다음과 같습니다:
| 메시지 | 의미 |
|---|---|
Your organization's security policy holds <package> <version> until <date>. | 정책에 따라 이 공개 버전은 표시된 날짜까지 보류됩니다. 기다리거나, 이전 버전에 의존하거나, 조직 관리자에게 조기 승인을 요청하세요. |
Your organization's security policy holds every version of <package>. | 이 공개 패키지의 모든 버전이 정책이 허용하는 기한보다 최근에 나왔습니다. 첫 버전은 표시된 날짜에 사용할 수 있게 됩니다. |
An organization admin rejected <package> <version>. | 조직 관리자가 이 버전을 반려했습니다. 다른 버전에 의존하거나, 관리자에게 반려 해제를 요청하세요. |
<package> <version> is quarantined while it is reviewed. | 이 버전은 검토 중이며, 검토가 끝날 때까지 누구에게도 제공되지 않습니다. 다른 버전에 의존하세요. |
<package> <version> was denied. | 검토 결과 이 버전에 문제가 있는 것으로 판정되었습니다. 다른 버전에 의존하세요. |
A security review flagged <package> <version>, … | 검토에서 이 버전에 플래그가 지정되었고, 정책(Strict)은 플래그가 지정된 버전을 제공하지 않습니다. 다른 버전에 의존하거나, 조직 관리자에게 예외 지정을 요청하세요. |
<package> <version> is waiting on a security review, … | 이 버전은 검토가 진행 중이며, 정책(Strict)에 따라 검토가 끝날 때까지 대기합니다. 다른 버전에 의존하거나, 조직 관리자에게 예외 지정을 요청하세요. |
<package> <version> does not meet your organization's quality gate. | 이 버전은 조직의 품질 게이트에 못 미칩니다. 메시지에 이유가 나열됩니다. 다른 버전에 의존하거나, 조직 관리자에게 예외 지정을 요청하세요. |
보안 페이지
조직 관리자는 Dartastic Pub에 로그인한 상태에서 보안 페이지 https://pub.dartastic.io/security-admin에서 이 모든 것을 관리합니다. 그곳에서 하는 모든 작업은 누가 언제 했는지와 함께 감사 기록에 남습니다. 관리자는 그곳에서 다음을 할 수 있습니다:
- 정책이 보류한 버전을 조기 승인하거나 반려
- 조직 자체 패키지의 버전을 격리, 격리 해제 또는 차단
- 조직 자체 패키지의 점수를 직접 설정
- 사유와 함께 예외를 추가하거나 제거
- 조직의 정책과 품질 게이트 선택
- 조직이 받은 버전 중 판정이나 알려진 보안 권고가 있는 모든 버전, 누가 몇 번 언제 받았는지, 어떤 자체 패키지가 그 버전에 의존하는지 확인