.nh
.TH podman-image-trust 1
.SH "نام (NAME)"
podman-image-trust \- مدیریت خط‌مشی اعتماد به رجیستری ایمیج‌های کانتینر

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman image trust\fP set|show [\fIگزینه‌ها\fP] \fIregistry[/repository]\fP

.SH "توضیحات (DESCRIPTION)"
رجیستری‌های مورد اعتماد به عنوان منبع ایمیج‌های کانتینر را بر اساس مکان آن‌ها مدیریت می‌کند. (این گزینه در کلاینت ریموت پادمن، از جمله سیستم‌های مک و ویندوز (به‌جز WSL2) در دسترس نیست).

.PP
مکان بر اساس شیوه انتقال (transport) و میزبان رجیستری ایمیج تعیین می‌شود. با در نظر گرفتن ایمیج کانتینر \fBdocker://docker.io/library/busybox\fR به عنوان مثال، \fBdocker\fR شیوه انتقال و \fBdocker.io\fR میزبان رجیستری است.

.PP
اعتماد در فایل \fB/etc/containers/policy.json\fP تعریف می‌شود و هنگامی که کاربر برای دریافت (pull) یک ایمیج ریموت از رجیستری تلاش می‌کند اعمال می‌گردد. خط‌مشی اعتماد در policy.json محدوده رجیستری (رجیستری و/یا مخزن) را برای اعتماد توصیف می‌کند. این سازوکار اعتماد می‌تواند از کلیدهای عمومی برای ایمیج‌های امضاشده استفاده کند.

.PP
محدوده اعتماد از خاص‌ترین به عام‌ترین ارزیابی می‌شود. به عبارت دیگر، یک خط‌مشی ممکن است:
.IP \(bu 2
برای کل یک رجیستری تعریف شود.
.IP \(bu 2
برای یک مخزن خاص در آن رجیستری تعریف شود.
.IP \(bu 2
برای یک ایمیج امضاشده خاص درون رجیستری تعریف شود.

.PP
فهرست زیر نمونه‌هایی از مقادیر معتبر محدوده در policy.json از خاص‌ترین به عام‌ترین است:

.PP
docker.io/library/busybox:notlatest

.PP
docker.io/library/busybox

.PP
docker.io/library

.PP
docker.io

.PP
اگر هیچ پیکربندی‌ای برای هیچ‌یک از این محدوده‌ها یافت نشود، مقدار پیش‌فرض (که با استفاده از "default" به جای REGISTRY[/REPOSITORY] مشخص می‌شود) استفاده خواهد شد.

.PP
نوع اعتماد (\fBtype\fP) روشی را برای موارد زیر فراهم می‌کند:

.PP
قرار دادن رجیستری‌ها در لیست مجاز ("accept") یا لیست مسدود ("reject")،
الزام به امضای ساده ("signedBy")،
الزام به امضای sigstore ("sigstoreSigned").

.PP
اعتماد را می‌توان با استفاده از دستور \fBpodman image trust set\fP برای یک محدوده اعتماد موجود به‌روزرسانی کرد.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--help\fP, \fB-h\fP
چاپ راهنمای نحوه استفاده.

.SS گزینه‌های set
.SS \fB--pubkeysfile\fP, \fB-f\fP=\fIKEY1\fP
مسیری به یک کلید عمومی برون‌بری‌شده در سیستم محلی. مسیرهای کلید در policy.json ارجاع داده می‌شوند. هر مسیری به یک فایل می‌تواند استفاده شود اما قرار دادن فایل در \fB/etc/pki/containers\fP توصیه می‌شود. از این گزینه می‌توان چندین بار برای الزام به امضای ایمیج با چندین کلید استفاده کرد. گزینه \fB--pubkeysfile\fP برای انواع \fBsignedBy\fP و \fBsigstoreSigned\fP الزامی است.

.SS \fB--signature-policy\fP=\fIpath\fP
مسیر فایل خط‌مشی امضا (\fBpolicy.json\fP) که پادمن آن را به‌روزرسانی می‌کند. این گزینه برای زیردستور \fBset\fP الزامی است.

.SS \fB--type\fP, \fB-t\fP=\fIvalue\fP
نوع اعتماد برای این ورودی خط‌مشی.
  مقادیر پذیرفته‌شده:
    \fBsignedBy\fP (پیش‌فرض): الزام به امضاهای ساده به همراه فهرست مربوط به کلیدهای عمومی
    \fBsigstoreSigned\fP: الزام به امضاهای sigstore به همراه فهرست مربوط به کلیدهای عمومی
    \fBaccept\fP: عدم الزام به هیچ‌گونه امضایی برای این محدوده رجیستری
    \fBreject\fP: عدم پذیرش ایمیج‌ها برای این محدوده رجیستری

.SS گزینه‌های show
.SS \fB--json\fP, \fB-j\fP
خروجی اعتماد در قالب JSON برای پردازش ماشینی

.SS \fB--noheading\fP, \fB-n\fP
حذف سرستون‌های جدول از خروجی فهرست.

.SS \fB--raw\fP
خروجی فایل خط‌مشی اعتماد به صورت JSON خام

.SS \fB--signature-policy\fP=\fIpath\fP
مسیر فایل خط‌مشی امضا (\fBpolicy.json\fP) برای نمایش. در صورت عدم تعیین، پادمن مسیر خط‌مشی را از پیکربندی سیستم به همان روشی که خط‌مشی دریافت ایمیج را انتخاب می‌کند شناسایی می‌نماید.

.SH "مثال‌ها (EXAMPLES)"
پذیرش تمام ایمیج‌های بدون امضا از یک رجیستری:

.EX
sudo podman image trust set --signature-policy /etc/containers/policy.json --type accept docker.io
.EE

.PP
تغییر خط‌مشی اعتماد پیش‌فرض:

.EX
sudo podman image trust set --signature-policy /etc/containers/policy.json -t reject default
.EE

.PP
نمایش خط‌مشی اعتماد سیستم:

.EX
podman image trust show
TRANSPORT      NAME                        TYPE        ID                   STORE
all            default                     reject
repository     docker.io/library           accept
repository     registry.access.redhat.com  signed      security@redhat.com  https://access.redhat.com/webassets/docker/content/sigstore
repository     registry.redhat.io          signed      security@redhat.com  https://registry.redhat.io/containers/sigstore
repository     docker.io                   reject
docker-daemon                              accept
.EE

.PP
نمایش فایل خط‌مشی اعتماد:

.EX
{
    "default": [
        {
            "type": "reject"
        }
    ],
    "transports": {
        "docker": {
            "docker.io": [
                {
                    "type": "reject"
                }
            ],
            "docker.io/library": [
                {
                    "type": "insecureAcceptAnything"
                }
            ],
            "registry.access.redhat.com": [
                {
                    "type": "signedBy",
                    "keyType": "GPGKeys",
                    "keyPath": "/etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release"
                }
            ],
            "registry.redhat.io": [
                {
                    "type": "signedBy",
                    "keyType": "GPGKeys",
                    "keyPath": "/etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release"
                }
            ]
        },
        "docker-daemon": {
            "": [
                {
                    "type": "insecureAcceptAnything"
                }
            ]
        }
    }
}
.EE

.PP
نمایش اعتماد به صورت JSON:

.EX
[
  {
    "transport": "all",
    "name": "* (default)",
    "repo_name": "default",
    "type": "reject"
  },
  {
    "transport": "repository",
    "name": "docker.io",
    "repo_name": "docker.io",
    "type": "reject"
  },
  {
    "transport": "repository",
    "name": "docker.io/library",
    "repo_name": "docker.io/library",
    "type": "accept"
  },
  {
    "transport": "repository",
    "name": "registry.access.redhat.com",
    "repo_name": "registry.access.redhat.com",
    "sigstore": "https://access.redhat.com/webassets/docker/content/sigstore",
    "type": "signed",
    "gpg_id": "security@redhat.com"
  },
  {
    "transport": "repository",
    "name": "registry.redhat.io",
    "repo_name": "registry.redhat.io",
    "sigstore": "https://registry.redhat.io/containers/sigstore",
    "type": "signed",
    "gpg_id": "security@redhat.com"
  },
  {
    "transport": "docker-daemon",
    "type": "accept"
  }
]
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBcontainers-policy.json(5)\fP

.SH "تاریخچه (HISTORY)"
ژانویه ۲۰۱۹، به‌روزرسانی‌شده توسط Tom Sweeney (tsweeney at redhat dot com)
.br
دسامبر ۲۰۱۸، در ابتدا توسط Qi Wang تدوین شد (qiwan at redhat dot com)