> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/kontenaimjisukyan/standalone-registries/generic-oci-compatible-registry.md).

# 汎用 OCI 互換レジストリ

このガイドを使って、画像スキャンのために任意の Docker/OCI 互換レジストリを Aikido に接続します。<br>

Aikido に必要なのは読み取り（pull）アクセスだけです。イメージの push、変更、削除は一切行いません。

## 前提条件

* OCI 互換のレジストリエンドポイント（例: registry.example.com）。
* スキャンしたいリポジトリに対して pull 権限を持つユーザー。

  対象を最小限のリポジトリまたは名前空間に限定します。
* （任意）レジストリがファイアウォールの内側にある場合は、Aikido の送信元 IP を許可リストに追加してください。

## 設定

### ステップ 1: レジストリで認証情報を作成する

イメージを pull できるユーザー名とアクセストークン/パスワードを作成します。

作成方法はプロバイダーによって異なります。レジストリのドキュメントで、次のいずれかを探してください:

* 「Personal access token」または「Robot/Service account」
* 「Read-only token」/「Pull-only token」
* 「Docker ログイン用パスワード」

### ステップ 2: docker login で確認する

Aikido に接続する前に、認証情報がローカルで機能することを確認してください。

```
docker logout registry.example.com 2>/dev/null || true
docker login registry.example.com
# ユーザー名: <your-username-or-service-account>
# パスワード: <your-access-token-or password>
```

次に、既知のイメージを pull して権限を確認します:

```
docker pull registry.example.com/namespace/image:tag
```

これが失敗する場合は、レジストリ内のトークンのスコープまたはリポジトリ権限を調整してください。

### ステップ 3: Aikido にレジストリを追加する

<figure><img src="/files/e027e401de9225a9d3016a59754e607839e3803d" alt=""><figcaption></figcaption></figure>

Container image registry connection で、以下を入力してください:

| Aikido 内の項目 | 入力内容                         | 例                    |
| ----------- | ---------------------------- | -------------------- |
| ユーザー名       | 作成したユーザー名またはサービス/ロボットアカウント   | robot\_aikido        |
| アクセストークン    | docker login で使用したトークン/パスワード | ••••••••             |
| レジストリ名      | レジストリのホスト名（プロトコルなし）          | registry.example.com |

「保存」をクリックします。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.aikido.dev/docs/docs-ja/kontenaimjisukyan/standalone-registries/generic-oci-compatible-registry.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.