انظر [التثبيت](#installation) و [الأمثلة الشائعة](#common-examples)

<img src="https://assets.kitploit.com/production/public/readmes/4137/343598bd4d53296c6d6d23acde8c2917d5727f03e7b3a34c1ff0865c435bb974.png" width="800">

# مقارنة نقاط الفحص

<img src="https://assets.kitploit.com/production/public/readmes/4137/4f4835c3a5fd70f436d9d8ea656fd8a521112fece4e35977288064d3f6f4510a.png" width="800">
<img src="https://assets.kitploit.com/production/public/readmes/4137/7bee9da0b061957af6a175a3b975dca82813c27f72ab6921dfe8ab2d6747322b.png" width="800">

# جدول المحتويات

- [الميزات](#features)
- [المقارنة](#comparison)
- [التثبيت](#installation)
  - [Homebrew (Mac OS X / Linux و WSL)](#homebrew-mac-os-x--linux-and-wsl)
  - [RHEL/CentOS](#rhelcentos)
  - [Debian/Ubuntu](#debianubuntu)
  - [Arch Linux](#arch-linux)
  - [ويندوز](#windows)
  - [Microsoft PowerShell 7](#microsoft-powershell-7)
  - [ثنائي (Binary)](#binary)
  - [asdf](#asdf)
  - [mise](#mise)
  - [من المصدر](#from-source)
  - [استخدام Docker](#use-docker)
- [البدء السريع](#quick-start)
  - [أساسي](#basic)
  - [Docker](#docker)
- [ملخص نقاط الفحص](#checkpoint-summary)
- [الأمثلة الشائعة](#common-examples)
  - [فحص صورة](#scan-an-image)
  - [فحص ملف صورة](#scan-an-image-file)
  - [الحصول على النتائج أو حفظها بصيغة JSON](#get-or-save-the-results-as-json)
  - [الحصول على النتائج أو حفظها بصيغة SARIF](#get-or-save-the-results-as-sarif)
  - [تحديد رمز الخروج](#specify-exit-code)
  - [تحديد مستوى الخروج](#specify-exit-level)
  - [تجاهل نقاط الفحص المحددة](#ignore-the-specified-checkpoints)
  - [قبول `المتغيرات البيئية` / `الملفات` / `امتدادات الملفات` المشبوهة](#accept-suspicious-environment-variables--files--file-extensions)
  - [رفض `المتغيرات البيئية` / `الملفات` / `امتدادات الملفات` المشبوهة](#reject-suspicious-environment-variables--files--file-extensions)
- [التكامل المستمر](#continuous-integration-ci)
  - [GitHub Action](#github-action)
  - [Travis CI](#travis-ci)
  - [CircleCI](#circleci)
  - [GitLab CI](#gitlab-ci)
  - [التفويض لسجل Docker الخاص](#authorization-for-private-docker-registry)
    - [Docker Hub](#docker-hub)
    - [Amazon ECR (Elastic Container Registry)](#amazon-ecr-elastic-container-registry)
    - [GCR (Google Container Registry)](#gcr-google-container-registry)
    - [السجل المستضاف ذاتيًا (BasicAuth)](#self-hosted-registry-basicauth)
- [المساهمون](#contributors)
  - [مساهمو الكود](#code-contributors)
  - [المساهمون الماليون](#financial-contributors)
    - [أفراد](#individuals)
    - [منظمات](#organizations)
- [الترخيص](#license)
- [المؤلف](#author)

# الميزات

- اكتشاف ثغرات الحاوية
- المساعدة في بناء Dockerfile بأفضل الممارسات
- استخدام بسيط
  - تحديد اسم الصورة فقط
  - انظر [البدء السريع](#quick-start) و [الأمثلة الشائعة](#common-examples)
- دعم معايير CIS
  - دقة عالية
- DevSecOps
  - مناسب لـ CI مثل Travis CI و CircleCI و Jenkins وغيرها
  - انظر [مثال CI](#continuous-integration-ci)

# المقارنة

|  | [Dockle](https://github.com/goodwithtech/dockle) | [Hadolint](https://github.com/hadolint/hadolint) | [Docker Bench for Security](https://github.com/docker/docker-bench-security) | [Clair](https://github.com/coreos/clair) |
|--- |---:|---:|---:|---:|
| الهدف |  الصورة | Dockerfile | المضيف<br/>Daemon Docker<br/>الصورة<br/>وقت تشغيل الحاوية | الصورة |
| طريقة التشغيل | ثنائي | ثنائي | سكربت شيل | ثنائي |
| الاعتماديات | لا | لا | بعض الاعتماديات | لا |
| مناسب لـ CI | ✓ | ✓ | x | x | 
| الغرض |مراجعة أمنية<br/>تدقيق Dockerfile| تدقيق Dockerfile | مراجعة أمنية<br/>تدقيق Dockerfile | فحص الثغرات |

# التثبيت

## Homebrew (Mac OS X / Linux و WSL)

يمكنك استخدام Homebrew على [Mac OS X](https://brew.sh/) أو [Linux و WSL (نظام ويندوز الفرعي للينكس)](https://docs.brew.sh/Homebrew-on-Linux).```bash
$ brew install goodwithtech/r/dockle

## Debian/Ubuntu```bash
VERSION=$(
 curl --silent "https://api.github.com/repos/goodwithtech/dockle/releases/latest" | \
 grep '"tag_name":' | \
 sed -E 's/.*"v([^"]+)".*/\1/' \
) && curl -L -o dockle.deb https://github.com/goodwithtech/dockle/releases/download/v${VERSION}/dockle_${VERSION}_Linux-64bit.deb
$ sudo dpkg -i dockle.deb && rm dockle.deb

## ويندوز```bash
VERSION=$(
 curl --silent "https://api.github.com/repos/goodwithtech/dockle/releases/latest" | \
 grep '"tag_name":' | \
 sed -E 's/.*"v([^"]+)".*/\1/' \
) && curl -L -o dockle.zip https://github.com/goodwithtech/dockle/releases/download/v${VERSION}/dockle_${VERSION}_Windows-64bit.zip
$ unzip dockle.zip && rm dockle.zip
$ ./dockle.exe [IMAGE_NAME]

## الملف الثنائي

يمكنك الحصول على أحدث نسخة ثنائية من [صفحة الإصدارات](https://github.com/goodwithtech/dockle/releases/latest).

قم بتنزيل ملف الأرشيف الخاص بنظام التشغيل/الهندسة المعمارية الخاصة بك. قم بفك ضغط الأرشيف، وضع الملف الثنائي في مكان ما في `$PATH` الخاص بك (على أنظمة يونكس، `/usr/local/bin` أو ما شابه ذلك).

- ملاحظة: تأكد من تمكين أذونات التنفيذ. (`chmod +x dockle`)

## asdf

يمكنك تثبيت dockle باستخدام [مدير الإصدارات asdf](https://asdf-vm.com/) عبر هذا [الملحق](https://github.com/mathew-fleisch/asdf-dockle)، والذي يقوم بأتمتة عملية تثبيت (والتبديل بين) إصدارات مختلفة من ملفات إصدارات github الثنائية. مع تثبيت asdf مسبقًا، قم بتشغيل هذه الأوامر لتثبيت dockle:```bash
# Add dockle plugin
asdf plugin add dockle

# Show all installable versions
asdf list-all dockle

# Install specific version
asdf install dockle latest

# Set a version globally (on your ~/.tool-versions file)
asdf global dockle latest

# Now dockle commands are available
dockle --version

## من المصدر```bash
$ GO111MODULE=off go get github.com/goodwithtech/dockle/cmd/dockle
$ cd $GOPATH/src/github.com/goodwithtech/dockle && GO111MODULE=on go build -o $GOPATH/bin/dockle cmd/dockle/main.go

تحتاج فقط إلى `-v /var/run/docker.sock:/var/run/docker.sock` عندما ترغب في فحص الصورة على جهاز المضيف الخاص بك.

## بدء سريع

## أساسي

ببساطة حدد اسم الصورة (وعلامة).```bash
$ dockle [YOUR_IMAGE_NAME]

### الحصول على النتائج أو حفظها بصيغة JSON```bash
$ dockle -f json goodwithtech/test-image:v1
$ dockle -f json -o results.json goodwithtech/test-image:v1

<details>
<summary>النتيجة</summary>```json
{
  "version": "2.1.0",
  "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json",
  "runs": [
    {
      "tool": {
        "driver": {
          "name": "Dockle",
          "informationUri": "https://github.com/goodwithtech/dockle",
          "rules": [
            {
              "id": "CIS-DI-0009",
              "shortDescription": {
                "text": "Use COPY instead of ADD in Dockerfile"
              },
              "help": {
                "text": "https://github.com/goodwithtech/dockle/blob/master/CHECKPOINT.md#CIS-DI-0009"
              }
            },
            {
              "id": "CIS-DI-0010",
              "shortDescription": {
                "text": "Do not store credential in ENVIRONMENT vars/files"
              },
              "help": {
                "text": "https://github.com/goodwithtech/dockle/blob/master/CHECKPOINT.md#CIS-DI-0010"
              }
            },
            {
              "id": "DKL-DI-0005",
              "shortDescription": {
                "text": "Clear apt-get caches"
              },
              "help": {
                "text": "https://github.com/goodwithtech/dockle/blob/master/CHECKPOINT.md#DKL-DI-0005"
              }
            },
            {
              "id": "DKL-LI-0001",
              "shortDescription": {
                "text": "Avoid empty password"
              },
              "help": {
                "text": "https://github.com/goodwithtech/dockle/blob/master/CHECKPOINT.md#DKL-LI-0001"
              }
            },
            {
              "id": "CIS-DI-0005",
              "shortDescription": {
                "text": "Enable Content trust for Docker"
              },
              "help": {
                "text": "https://github.com/goodwithtech/dockle/blob/master/CHECKPOINT.md#CIS-DI-0005"
              }
            },
            {
              "id": "CIS-DI-0008",
              "shortDescription": {
                "text": "Confirm safety of setuid/setgid files"
              },
              "help": {
                "text": "https://github.com/goodwithtech/dockle/blob/master/CHECKPOINT.md#CIS-DI-0008"
              }
            },
            {
              "id": "CIS-DI-0001",
              "shortDescription": {
                "text": "Create a user for the container"
              },
              "help": {
                "text": "https://github.com/goodwithtech/dockle/blob/master/CHECKPOINT.md#CIS-DI-0001"
              }
            },
            {
              "id": "CIS-DI-0006",
              "shortDescription": {
                "text": "Add HEALTHCHECK instruction to the container image"
              },
              "help": {
                "text": "https://github.com/goodwithtech/dockle/blob/master/CHECKPOINT.md#CIS-DI-0006"
              }
            }
          ]
        }
      },
      "results": [
        {
          "ruleId": "CIS-DI-0009",
          "level": "error",
          "message": {
            "text": "Use COPY : /bin/sh -c #(nop) ADD file:81c0a803075715d1a6b4f75a29f8a01b21cc170cfc1bff6702317d1be2fe71a3 in /app/credentials.json "
          }
        },
        {
          "ruleId": "CIS-DI-0010",
          "level": "error",
          "message": {
            "text": "Suspicious filename found : app/credentials.json , Suspicious ENV key found : MYSQL_PASSWD"
          }
        },
        {
          "ruleId": "DKL-DI-0005",
          "level": "error",
          "message": {
            "text": "Use 'rm -rf /var/lib/apt/lists' after 'apt-get install' : /bin/sh -c apt-get update \u0026\u0026 apt-get install -y git"
          }
        },
        {
          "ruleId": "DKL-LI-0001",
          "level": "error",
          "message": {
            "text": "No password user found! username : nopasswd"
          }
        },
        {
          "ruleId": "CIS-DI-0005",
          "level": "note",
          "message": {
            "text": "export DOCKER_CONTENT_TRUST=1 before docker pull/build"
          }
        },
        {
          "ruleId": "CIS-DI-0008",
          "level": "note",
          "message": {
            "text": "setuid file: urwxr-xr-x usr/bin/newgrp, setgid file: grwxr-xr-x usr/bin/ssh-agent, setgid file: grwxr-xr-x usr/bin/expiry, setuid file: urwxr-xr-x usr/lib/openssh/ssh-keysign, setuid file: urwxr-xr-x bin/umount, setgid file: grwxr-xr-x usr/bin/chage, setuid file: urwxr-xr-x usr/bin/passwd, setgid file: grwxr-xr-x sbin/unix_chkpwd, setuid file: urwxr-xr-x usr/bin/chsh, setgid file: grwxr-xr-x usr/bin/wall, setuid file: urwxr-xr-x bin/ping, setuid file: urwxr-xr-x bin/su, setuid file: urwxr-xr-x usr/bin/chfn, setuid file: urwxr-xr-x usr/bin/gpasswd, setuid file: urwxr-xr-x bin/mount"
          }
        },
        {
          "ruleId": "CIS-DI-0001",
          "level": "none",
          "message": {
            "text": "Last user should not be root"
          }
        },
        {
          "ruleId": "CIS-DI-0006",
          "level": "none",
          "message": {
            "text": "not found HEALTHCHECK statement"
          }
        }
      ]
    }
  ]
}

### تحديد مستوى الخروج

بشكل افتراضي، يتم تشغيل `--exit-code` عند وجود تنبيهات بمستوى `WARN` أو `FATAL`.

استخدم الخيار `--exit-level, -l` لتغيير مستوى التنبيه. يمكنك تعيين `info` أو `warn` أو `fatal`.```bash
$ dockle --exit-code 1 --exit-level info [IMAGE_NAME]
$ dockle --exit-code 1 --exit-level fatal [IMAGE_NAME]

أو، استخدم `DOCKLE_IGNORES`:```
export DOCKLE_IGNORES=CIS-DI-0001,DKL-DI-0006
dockle [IMAGE_NAME]

### قبول المشبوهة `environment variables` / `files` / `file extensions````bash
# --accept-key value, --ak value             You can add acceptable keywords.
dockle -ak GPG_KEY -ak KEYCLOAK_VERSION [IMAGE_NAME]
or DOCKLE_ACCEPT_KEYS=GPG_KEY,KEYCLOAK_VERSION dockle [IMAGE_NAME]

# --accept-file value, --af value            You can add acceptable file names.
dockle -af id_rsa -af id_dsa [IMAGE_NAME]
or DOCKLE_ACCEPT_FILES=id_rsa,id_dsa dockle [IMAGE_NAME]

# --accept-file-extension value, --ae value  You can add acceptable file extensions.
dockle -ae pem -ae log [IMAGE_NAME]
or DOCKLE_ACCEPT_FILE_EXTENSIONS=pem,log dockle [IMAGE_NAME]

## التكامل المستمر (CI)

يمكنك فحص صورتك المبنية باستخدام `Dockle` في Travis CI/CircleCI.

في هذه الأمثلة، سيفشل الاختبار إذا تم العثور على أي تحذيرات.

ومع ذلك، يمكنك تجاهل نقاط التفتيش المستهدفة المحددة باستخدام ملف `.dockleignore`.

أو، إذا كنت تريد فقط عرض النتائج وعدم جعل الاختبار يفشل لهذا، فحدد `--exit-code` إلى `0` في أمر `dockle`.

### إجراء GitHub

نقدم [goodwithtech/dockle-action](https://github.com/goodwithtech/dockle-action).```yaml
- uses: goodwithtech/dockle-action@main
  with:
    image: 'target'
    format: 'list'
    exit-code: '1'
    exit-level: 'warn'
    ignore: 'CIS-DI-0001,DKL-DI-0006'