Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 16 additions & 2 deletions .agents/skills/localize-rustfs-docs/references/ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,8 +54,22 @@ Treat RustFS source code, APIs, and exact Console labels as authoritative for pr
| multipart upload | マルチパートアップロード | Preserve API actions such as `CreateMultipartUpload`. |
| server-side encryption | サーバー側の暗号化 | Keep SSE-S3, SSE-KMS, and SSE-C unchanged. |
| presigned URL | 署名付き URL | Keep URL uppercase and preserve API names. |
| path-style addressing | パス形式のアドレス指定 | Preserve SDK option names. |
| virtual-hosted-style addressing | 仮想ホスト形式のアドレス指定 | Relate it to `RUSTFS_SERVER_DOMAINS` when relevant. |
| path-style addressing | パススタイルアクセス | Preserve SDK option names such as `forcePathStyle`. Do not use パス形式のアドレス指定. |
| virtual-hosted-style addressing | 仮想ホスト形式 | バーチャルホストスタイル is acceptable. Relate it to `RUSTFS_SERVER_DOMAINS` when relevant. Preserve SDK option names. |
| cluster | クラスター | Keep the long vowel. Do not write クラスタ. |
| deployment | デプロイ | Prefer this over デプロイメント. |
| interface | インターフェース | Do not write インターフェイス. |
| matrix | マトリックス | Do not write マトリクス. |
| compatibility gate | 互換性検証(ゲート) | Explain the gate on first use. |
| executable test list | 実行対象のテストリスト | Do not write 実行可能なテストリスト. |
| Planned (status) | 未実装(予定) | Do not use 予定 alone. |
| round-trip | 往復検証 | A parenthetical round-trip is optional. |
| credential vending | 認証情報ベンディング / 一時認証情報の発行 | Do not write 認証情報の払い出し. |
| authorized principal | 認可されたプリンシパル | Do not write 認可済みの主体. |
| backend | バックエンド | Do not leave the English word in prose. |
| repository | リポジトリ | Do not leave Repository in prose. |
| Next steps | 次のステップ | Do not write 次の手順. |
| overview / product introduction | 概要 | Do not use 製品紹介 for a technical introduction. |
| health check | ヘルスチェック | Preserve endpoint paths and probe names. |
| readiness | Readiness / 準備完了状態 | Preserve `/health/ready` and Kubernetes field names. |
| observability | オブザーバビリティ | Keep OpenTelemetry and OTLP unchanged. |
Expand Down
66 changes: 33 additions & 33 deletions content/ja/administration/console/index.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: "Console"
description: "Enable the RustFS Console, connect it to a server, and sign in securely."
title: "コンソール"
description: "RustFS Console を有効にし、サーバーへ接続して、安全にサインインします。"
---

The **RustFS Console** is the web administration interface for RustFS. Use this page to enable the Console, open the login page, and choose the appropriate sign-in method. Detailed procedures for buckets, objects, and identity management are covered in their respective documentation sections.
**RustFS Console** は、RustFS の Web 管理インターフェースです。このページでは、Console の有効化、ログインページを開く手順、適切なサインイン方法の選択を説明します。バケット、オブジェクト、アイデンティティ管理の詳しい手順は、それぞれのドキュメントで扱います。

## Enable the Console
## Console を有効にする

The Console is enabled by default and listens on port `9001`, separately from the S3 API on port `9000`. You can set the behavior explicitly with the following environment variables:
Console は既定で有効であり、ポート `9000` の S3 API とは別に、ポート `9001` で待ち受けます。次の環境変数で、動作を明示的に設定できます。

```ini title="/etc/default/rustfs"
RUSTFS_ADDRESS=":9000"
Expand All @@ -17,56 +17,56 @@ RUSTFS_OBS_LOGGER_LEVEL=error
RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/"
```

Restart RustFS after changing these values. Set `RUSTFS_CONSOLE_ENABLE=false` when the Console must not run.
これらの値を変更したあとは、RustFS を再起動します。Console を実行してはならない場合は、`RUSTFS_CONSOLE_ENABLE=false` を設定します。

The equivalent command-line options are `--console-enable` and `--console-address`. See the [CLI reference](/reference/cli) and [environment variable reference](/reference/environment-variables) for the complete server configuration.
同等のコマンドラインオプションは `--console-enable` と `--console-address` です。サーバー設定の全体は、[CLI リファレンス](/ja/reference/cli) と [環境変数リファレンス](/ja/reference/environment-variables) を参照します。

## Open the Console
## Console を開く

Open the following address, replacing `<server-ip>` with the RustFS server address:
`<server-ip>` を RustFS サーバーのアドレスに置き換えて、次のアドレスを開きます。

```text
http://<server-ip>:9001
```

![RustFS Console login page with key, STS, and OIDC sign-in options](./images/rustfs-console-login.png)
![キー、STS、OIDC のサインイン方法を示す RustFS Console のログインページ](./images/rustfs-console-login.png)

For a local deployment, use `http://localhost:9001`. Windows and macOS desktop launchers use port `7001` instead.
Windows および macOS のデスクトップランチャーを含むローカルデプロイでは、`http://localhost:9001` を開きます。S3 API はポート `9000` で待ち受けます。

If the login page cannot reach the target RustFS service, select **Server Configuration** or open `/config`. Enter the externally reachable RustFS service address and save it after the health check succeeds. **Reset** clears the saved address; **Skip** returns to login without changing it.
ログインページから対象の RustFS サービスへ到達できない場合は、**Server Configuration**(サーバー設定)を選ぶか、`/config` を開きます。外部から到達できる RustFS サービスのアドレスを入力し、ヘルスチェックが成功してから保存します。**Reset**(リセット)は、保存したアドレスを消去します。**Skip**(スキップ)は、アドレスを変更せずにログインへ戻ります。

## Log in
## ログイン

The login methods shown depend on the deployment configuration:
表示されるログイン方法は、デプロイの設定によって異なります。

- **Key Login** uses the access key and secret key configured for the RustFS deployment. This is the standard login method for a local administrator.
- **STS Login** uses temporary Security Token Service (STS) credentials. Use it only when your identity workflow has issued a valid session token.
- **OIDC Login** appears when an OpenID Connect (OIDC) provider is configured. Select the provider and complete authentication with the identity provider.
- **Key Login**(キーによるログイン)は、RustFS デプロイに設定したアクセスキーとシークレットキーを使います。ローカル管理者の標準的なログイン方法です。
- **STS Login**(STS ログイン)は、一時的な Security Token Service(STS)の認証情報を使います。アイデンティティのワークフローが有効なセッショントークンを発行している場合にだけ使います。
- **OIDC Login**(OIDC ログイン)は、OpenID Connect(OIDC)プロバイダーを設定しているときに表示されます。プロバイダーを選び、アイデンティティプロバイダーで認証を完了します。

After login, the Console opens the first page your account can access. Menus and actions vary by account policy and enabled platform capabilities; a missing menu does not necessarily indicate a Console error.
ログインすると、Console はそのアカウントがアクセスできる最初のページを開きます。メニューと操作は、アカウントのポリシーと、有効になっているプラットフォーム機能によって異なります。メニューが表示されないことは、必ずしも Console のエラーを意味しません。

If login fails, verify the selected login method, credentials, target server address, and account status before retrying.
ログインに失敗した場合は、再試行する前に、選択したログイン方法、認証情報、対象サーバーのアドレス、アカウントの状態を確認します。

:::warning[Do not expose default credentials]
:::warning[既定の認証情報を公開しない]

RustFS falls back to `rustfsadmin` / `rustfsadmin` when custom credentials are not configured. Use these defaults only for a throwaway local test. Configure a unique access key and a strong secret key before making the Console reachable by other users.
カスタムの認証情報を設定していない場合、RustFS は `rustfsadmin` / `rustfsadmin` にフォールバックします。これらの既定値は、使い捨てるローカルテストにだけ使います。ほかのユーザーから Console へ到達できるようにする前に、固有のアクセスキーと強いシークレットキーを設定します。

:::

## Operational notes
## 運用上の注意

- Use [TLS](/integration/tls-configured) before exposing the Console outside a trusted network.
- Restrict network access to the Console listener and configure [Console CORS](/administration/cors) only when cross-origin access is required.
- The Console session inherits the permissions of the signed-in identity. Use a least-privilege account for routine work.
- Signing out or an expired session returns you to the login page. Do not store administrator credentials in shared browsers.
- 信頼できるネットワークの外へ Console を公開する前に、[TLS](/ja/integration/tls-configured) を使います。
- Console のリスナーへのネットワークアクセスを制限し、クロスオリジンアクセスが必要な場合にだけ [Console の CORS](/ja/administration/cors) を設定します。
- Console のセッションは、サインインしたアイデンティティの権限を継承します。日常の作業には、最小権限のアカウントを使います。
- サインアウトしたとき、またはセッションの有効期限が切れたときは、ログインページに戻ります。共有ブラウザに管理者の認証情報を保存してはなりません。

## Management workflows
## 管理ワークフロー

- [Create and manage buckets](/administration/data/bucket/creation)
- [Upload and manage objects](/administration/data/object/creation)
- [Manage access keys](/security-compliance/iam/access-token)
- [Configure identity and access management](/security-compliance/iam)
- [バケットを作成して管理する](/ja/administration/data/bucket/creation)
- [オブジェクトをアップロードして管理する](/ja/administration/data/object/creation)
- [アクセスキーを管理する](/ja/security-compliance/iam/access-token)
- [アイデンティティとアクセス管理を設定する](/ja/security-compliance/iam)

## Next steps
## 次のステップ

Review the [security checklist](/installation/requirement/checklists/security-checklists) before exposing the Console outside a trusted network. For OIDC-based login, continue with the [OIDC configuration guide](/security-compliance/oidc).
信頼できるネットワークの外へ Console を公開する前に、[セキュリティチェックリスト](/ja/installation/requirement/checklists/security-checklists) を確認します。OIDC によるログインは、[OIDC 設定ガイド](/ja/security-compliance/oidc) に進みます。
34 changes: 17 additions & 17 deletions content/ja/administration/cors/index.md
Original file line number Diff line number Diff line change
@@ -1,50 +1,50 @@
---
title: "CORS Configuration"
description: "Configure allowed browser origins for the RustFS S3 API and Console."
title: "CORS の設定"
description: "RustFS の S3 API と Console について、ブラウザから許可するオリジンを設定します。"
---

Cross-Origin Resource Sharing (CORS) controls which browser origins can access the RustFS S3 API and Console. Configure each listener separately, then restart RustFS to apply the environment changes.
Cross-Origin Resource Sharing(CORS)は、どのブラウザオリジンが RustFS の S3 API と Console にアクセスできるかを制御します。リスナーごとに設定したあと、環境変数の変更を反映するために RustFS を再起動します。

## S3 API origins
## S3 API のオリジン

Set `RUSTFS_CORS_ALLOWED_ORIGINS` to a comma-separated list of trusted origins:
`RUSTFS_CORS_ALLOWED_ORIGINS` に、信頼できるオリジンをカンマ区切りで設定します。

```ini title="/etc/default/rustfs"
RUSTFS_CORS_ALLOWED_ORIGINS="https://app.example.com,https://admin.example.com"
```

When this variable is unset or empty, the S3 endpoint does not add generic CORS response headers. A list of explicit origins allows credentialed browser requests from matching origins.
この変数が未設定または空のとき、S3 エンドポイントは汎用の CORS 応答ヘッダーを付加しません。明示したオリジンの一覧を設定すると、一致するオリジンからの、認証情報を伴うブラウザリクエストが許可されます。

You can set the value to `*` to allow requests from any origin. Wildcard mode does not allow browser credentials.
任意のオリジンからのリクエストを許可するには、値を `*` にできます。ワイルドカードモードでは、ブラウザの認証情報は許可されません。

:::warning[Use explicit origins in production]
:::warning[本番では明示したオリジンを使う]

Use a comma-separated allowlist for applications that send credentials. Reserve `*` for public resources that do not require credentialed browser requests.
認証情報を送信するアプリケーションには、カンマ区切りの許可リストを使います。認証情報を伴うブラウザリクエストが不要な公開リソースに限り、`*` を使います。

:::

## Console origins
## Console のオリジン

The Console uses a separate variable:
Console は、別の変数を使います。

```ini title="/etc/default/rustfs"
RUSTFS_CONSOLE_CORS_ALLOWED_ORIGINS="https://admin.example.com"
```

Use a comma-separated list when more than one browser origin must access the Console. Set `*` only when any origin must be allowed.
複数のブラウザオリジンが Console にアクセスする必要がある場合は、カンマ区切りの一覧を使います。任意のオリジンを許可する必要がある場合にだけ、`*` を設定します。

## Verify the response
## 応答を確認する

Send a request with an `Origin` header and inspect the CORS response headers:
`Origin` ヘッダーを付けてリクエストを送り、CORS の応答ヘッダーを確認します。

```bash
curl -i \
-H "Origin: https://app.example.com" \
http://localhost:9000/
```

Confirm that `Access-Control-Allow-Origin` contains the expected origin. Repeat the check with an unlisted origin and confirm that it is not allowed.
`Access-Control-Allow-Origin` に、想定したオリジンが含まれていることを確認します。一覧にないオリジンでも確認を繰り返し、許可されていないことを確認します。

## Next steps
## 次のステップ

See the [environment variable reference](/reference/environment-variables#cors) for the verified defaults and configuration formats.
検証済みの既定値と設定形式は、[環境変数リファレンス](/ja/reference/environment-variables#cors) を参照します。
36 changes: 18 additions & 18 deletions content/ja/administration/data/bucket/creation.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,28 @@
---
title: "RustFS Bucket Creation"
description: "Create buckets using the RustFS UI, rc, or the S3 API."
title: "バケットの作成"
description: "RustFS の UI、rc、または S3 API を使ってバケットを作成します。"
---

This guide explains how to create buckets using the RustFS UI, `rc`, or the S3 API.
このガイドでは、RustFS の UI、`rc`、または S3 API を使ってバケットを作成する方法を説明します。

## Requirements
## 要件

- A running RustFS instance (see [Installation Guide](../../../installation/index.md)).
- [`rc`](/operations/rc) installed and configured with an alias for the command-line workflow.
- 稼働中の RustFS インスタンス([インストールガイド](../../../installation/index.md) を参照)。
- コマンドラインの手順では、[`rc`](/ja/operations/rc) をインストールし、エイリアスを設定します。

## Using the RustFS UI
## RustFS Console を使う

1. Log in to the RustFS Console.
2. On the Buckets page, in the top right corner, select **Create Bucket**.
3. Enter the bucket name and click **Create** to complete bucket creation.
1. RustFS Console にログインします。
2. **Buckets**(バケット)のページで、右上の **Create Bucket**(バケットを作成)を選びます。
3. バケット名を入力し、**Create**(作成)を選びます。

![bucket creation](images/bucket-creation-by-ui.png)
![バケットの作成](images/bucket-creation-by-ui.png)

## Using `rc`
## `rc` を使う

See the [`rc` guide](/operations/rc) for installation and alias configuration.
インストールとエイリアスの設定は、[`rc` ガイド](/ja/operations/rc) を参照します。

Create a bucket:
バケットを作成します。

```bash
rc bucket create rustfs/my-bucket
Expand All @@ -33,20 +33,20 @@ rc bucket list rustfs/
✓ Bucket 'rustfs/my-bucket' created successfully.
```

## Using the API
## API を使う

Create a bucket via API:
API でバケットを作成します。

```http
PUT /{bucketName} HTTP/1.1
```

S3 requests must be signed with AWS Signature V4, so use an S3 client rather than hand-crafting headers. With the [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) configured for your access keys:
S3 リクエストは、AWS 署名バージョン 4 で署名する必要があります。ヘッダーを手作業で組み立てず、S3 クライアントを使います。アクセスキーを設定した [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) では、次のように実行します。

```bash
aws s3api create-bucket \
--bucket bucket-creation-by-api \
--endpoint-url http://localhost:9000
```

Verify the bucket creation in the RustFS Console.
RustFS Console に、そのバケットが表示されることを確認します。
Loading
Loading