Skip to content
Open
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
15 changes: 10 additions & 5 deletions wolfCLU/Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,14 @@ SOURCES = Intro.md \
command_list.md \
bench.md \
ca.md \
crl.md \
crl.md \
dsaparam.md \
dgst.md \
dgst.md \
dhparam.md \
ecparam.md \
enc.md \
ecc.md \
ecparam.md \
ed25519.md \
enc.md \
genkey.md \
hash.md \
md5.md \
Expand All @@ -26,9 +28,12 @@ SOURCES = Intro.md \
rsa.md \
sha.md \
s_client.md \
s_server.md \
verify.md \
version.md \
x509.md \
base64.md
base64.md \
config.md

ifeq ($(DOC_LANG),JA)
PDF = wolfCLU-Manual-jp.pdf
Expand Down
4 changes: 4 additions & 0 deletions wolfCLU/mkdocs-ja.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,9 @@ nav:
- "DSAPARAM コマンド": dsaparam.md
- "DGST コマンド": dgst.md
- "DHPARAM コマンド": dhparam.md
- "ECC コマンド": ecc.md
- "ECPARAM コマンド": ecparam.md
- "ED25519 コマンド": ed25519.md
- "ENC コマンド": enc.md
- "GENKEY コマンド": genkey.md
- "HASH コマンド": hash.md
Expand All @@ -28,7 +30,9 @@ nav:
- "RSA コマンド": rsa.md
- "SHA コマンド": sha.md
- "S_CLIENT コマンド": s_client.md
- "S_SERVER コマンド": s_server.md
- "VERIFY コマンド": verify.md
- "VERSION コマンド": version.md
- "X509 コマンド": x509.md
- "BASE64 コマンド": base64.md
- "付録":
Expand Down
4 changes: 4 additions & 0 deletions wolfCLU/mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,9 @@ nav:
- "DSAPARAM Command": dsaparam.md
- "DGST Command": dgst.md
- "DHPARAM Command": dhparam.md
- "ECC Command": ecc.md
- "ECPARAM Command": ecparam.md
- "ED25519 Command": ed25519.md
- "ENC Command": enc.md
- "GENKEY Command": genkey.md
- "HASH Command": hash.md
Expand All @@ -28,7 +30,9 @@ nav:
- "RSA Command": rsa.md
- "SHA Command": sha.md
- "S_CLIENT Command": s_client.md
- "S_SERVER Command": s_server.md
- "VERIFY Command": verify.md
- "VERSION Command": version.md
- "X509 Command": x509.md
- "BASE64 Command": base64.md
- "Appendix":
Expand Down
3 changes: 0 additions & 3 deletions wolfCLU/src-ja/ca.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,3 @@ DNS.2 = www.example.com
wolfssl ca -config ca.conf -extensions v3_ca -in server.csr -out server-signed.pem -keyfile ca.priv -cert ca.pem -days 365 -md sha256
```

### 制限事項

設定ファイルを使用しない場合、wolfCLUは署名された各証明書にランダムなシリアル番号を生成します。設定ファイルベースのシリアル番号管理とその現在の制限事項については、[設定ファイル - 制限事項](config.md#制限事項)を参照してください。
6 changes: 2 additions & 4 deletions wolfCLU/src-ja/config.md
Original file line number Diff line number Diff line change
Expand Up @@ -272,14 +272,12 @@ commonName = myserver
wolfssl req -new -config simple.conf -key server.priv -out server.csr
```

## 制限事項

### シリアル番号ファイル
## シリアル番号ファイル

`serial` ディレクティブは、16進形式のシリアル番号を含むファイルを指定します:

```
01
```

**注意:** 現在のバージョン(v0.1.8)では、設定ファイルベースのシリアル番号管理にパス処理の問題があります。この問題が解決されるまで、コマンドライン引数を直接使用することを推奨します。設定ファイルを使用しない場合、wolfCLUは署名された各証明書にランダムなシリアル番号を生成します。
シリアル番号は証明書が署名されるたびにインクリメントされます。シリアルファイルを指定する設定ファイルを使用しない場合、wolfCLUは署名された各証明書にランダムなシリアル番号を生成します。
33 changes: 33 additions & 0 deletions wolfCLU/src-ja/ecc.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
### ECC コマンド

ECC(楕円曲線暗号)鍵を使用してデータの署名・検証を行います。

引数:

- [-sign] 署名操作
- [-verify] 検証操作
- [-inkey] 入力鍵ファイル
- [-in] 署名または検証する入力ファイル
- [-out] 署名の出力ファイル(署名操作時)
- [-sigfile] 署名ファイル(検証操作時)
- [-pubin] 入力鍵が公開鍵であることを指定(検証操作時)

使用例:

ECC秘密鍵でファイルに署名:

```
wolfssl ecc -sign -inkey ecc-priv.pem -in file.txt -out file.sig
```

ECC公開鍵で署名を検証:

```
wolfssl ecc -verify -inkey ecc-pub.pem -sigfile file.sig -in file.txt -pubin
```

ECC秘密鍵で署名を検証:

```
wolfssl ecc -verify -inkey ecc-priv.pem -sigfile file.sig -in file.txt
```
33 changes: 33 additions & 0 deletions wolfCLU/src-ja/ed25519.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
### ED25519 コマンド

Ed25519鍵を使用してデータの署名・検証を行います。

引数:

- [-sign] 署名操作
- [-verify] 検証操作
- [-inkey] 入力鍵ファイル
- [-in] 署名または検証する入力ファイル
- [-out] 署名の出力ファイル(署名操作時)
- [-sigfile] 署名ファイル(検証操作時)
- [-pubin] 入力鍵が公開鍵であることを指定(検証操作時)

使用例:

Ed25519秘密鍵でファイルに署名:

```
wolfssl ed25519 -sign -inkey ed25519-priv.pem -in file.txt -out file.sig
```

Ed25519公開鍵で署名を検証:

```
wolfssl ed25519 -verify -inkey ed25519-pub.pem -sigfile file.sig -in file.txt -pubin
```

Ed25519秘密鍵で署名を検証:

```
wolfssl ed25519 -verify -inkey ed25519-priv.pem -sigfile file.sig -in file.txt
```
35 changes: 35 additions & 0 deletions wolfCLU/src-ja/s_server.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
### S_SERVER コマンド

テスト用のシンプルなSSL/TLSサーバーです。指定したポートでリッスンし、SSL/TLS接続を処理します。

引数:

- [-port] リッスンするポート番号
- [-key] 秘密鍵ファイル(PEM形式)
- [-cert] 証明書ファイル(PEM形式)
- [-noVerify] クライアント証明書の検証を無効化
- [-CAfile] クライアント検証用のCA証明書ファイル(PEM形式)
- [-version] SSL/TLSバージョン: 0=SSLv3, 1=TLS1.0, 2=TLS1.1, 3=TLS1.2, 4=TLS1.3
- [-naccept] 受け付ける接続数(デフォルト: 1)
- [-www] HTTPレスポンスをHTML形式で送信
- [-readyFile] 外部モニタリング用のreadyファイルを作成

使用例:

ポート4433でシンプルなTLSサーバーを起動:

```
wolfssl s_server -port 4433 -cert server-cert.pem -key server-key.pem
```

クライアント証明書検証付きでサーバーを起動:

```
wolfssl s_server -port 4433 -cert server-cert.pem -key server-key.pem -CAfile ca-cert.pem
```

複数接続を受け付けHTTPレスポンスを返すサーバーを起動:

```
wolfssl s_server -port 4433 -cert server-cert.pem -key server-key.pem -naccept 10 -www
```
16 changes: 16 additions & 0 deletions wolfCLU/src-ja/version.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
### VERSION コマンド

wolfCLUとリンクされたwolfSSLライブラリのバージョン情報を表示します。

使用例:

```
wolfssl version
```

出力例:

```
You are using version 0.1.9 of the wolfssl Command Line Utility.
Linked to wolfSSL version 5.8.4
```
3 changes: 0 additions & 3 deletions wolfCLU/src/ca.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,3 @@ Sign CSR with extensions from config:
wolfssl ca -config ca.conf -extensions v3_ca -in server.csr -out server-signed.pem -keyfile ca.priv -cert ca.pem -days 365 -md sha256
```

### Limitations

Without a configuration file, wolfCLU generates a random serial number for each signed certificate. See [Configuration File - Limitations](config.md#limitations) for details on config file-based serial number management and its current limitations.
6 changes: 2 additions & 4 deletions wolfCLU/src/config.md
Original file line number Diff line number Diff line change
Expand Up @@ -272,14 +272,12 @@ Usage:
wolfssl req -new -config simple.conf -key server.priv -out server.csr
```

## Limitations

### Serial Number File
## Serial Number File

The `serial` directive specifies a file containing the serial number in hexadecimal format:

```
01
```

**Note:** In the current version (v0.1.8), the configuration file-based serial number management has known issues with path handling. It is recommended to use command-line arguments directly until this is resolved. Without a configuration file, wolfCLU generates a random serial number for each signed certificate.
The serial number is incremented after each certificate is signed. Without a configuration file specifying a serial file, wolfCLU generates a random serial number for each signed certificate.
33 changes: 33 additions & 0 deletions wolfCLU/src/ecc.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
### ECC Command

Sign and verify data using ECC (Elliptic Curve Cryptography) keys.

Arguments:

- [-sign] Sign operation
- [-verify] Verify operation
- [-inkey] Input key file
- [-in] Input file to sign or verify
- [-out] Output file for signature (sign operation)
- [-sigfile] Signature file (verify operation)
- [-pubin] Input key is a public key (for verify operation)

Usage Examples:

Sign a file with ECC private key:

```
wolfssl ecc -sign -inkey ecc-priv.pem -in file.txt -out file.sig
```

Verify a signature with ECC public key:

```
wolfssl ecc -verify -inkey ecc-pub.pem -sigfile file.sig -in file.txt -pubin
```

Verify a signature with ECC private key:

```
wolfssl ecc -verify -inkey ecc-priv.pem -sigfile file.sig -in file.txt
```
33 changes: 33 additions & 0 deletions wolfCLU/src/ed25519.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
### ED25519 Command

Sign and verify data using Ed25519 keys.

Arguments:

- [-sign] Sign operation
- [-verify] Verify operation
- [-inkey] Input key file
- [-in] Input file to sign or verify
- [-out] Output file for signature (sign operation)
- [-sigfile] Signature file (verify operation)
- [-pubin] Input key is a public key (for verify operation)

Usage Examples:

Sign a file with Ed25519 private key:

```
wolfssl ed25519 -sign -inkey ed25519-priv.pem -in file.txt -out file.sig
```

Verify a signature with Ed25519 public key:

```
wolfssl ed25519 -verify -inkey ed25519-pub.pem -sigfile file.sig -in file.txt -pubin
```

Verify a signature with Ed25519 private key:

```
wolfssl ed25519 -verify -inkey ed25519-priv.pem -sigfile file.sig -in file.txt
```
35 changes: 35 additions & 0 deletions wolfCLU/src/s_server.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
### S_SERVER Command

A simple SSL/TLS server for testing. Listens on a specified port and handles incoming SSL/TLS connections.

Arguments:

- [-port] Port number to listen on
- [-key] Private key file (PEM format)
- [-cert] Certificate file (PEM format)
- [-noVerify] Disable client certificate verification
- [-CAfile] CA certificate file for client verification (PEM format)
- [-version] SSL/TLS version: 0=SSLv3, 1=TLS1.0, 2=TLS1.1, 3=TLS1.2, 4=TLS1.3
- [-naccept] Number of connections to accept (default: 1)
- [-www] Send HTTP response in HTML format
- [-readyFile] Create a ready file for external monitoring

Usage Examples:

Start a simple TLS server on port 4433:

```
wolfssl s_server -port 4433 -cert server-cert.pem -key server-key.pem
```

Start server with client certificate verification:

```
wolfssl s_server -port 4433 -cert server-cert.pem -key server-key.pem -CAfile ca-cert.pem
```

Start server accepting multiple connections with HTTP response:

```
wolfssl s_server -port 4433 -cert server-cert.pem -key server-key.pem -naccept 10 -www
```
16 changes: 16 additions & 0 deletions wolfCLU/src/version.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
### VERSION Command

Displays version information for wolfCLU and the linked wolfSSL library.

Usage:

```
wolfssl version
```

Example Output:

```
You are using version 0.1.9 of the wolfssl Command Line Utility.
Linked to wolfSSL version 5.8.4
```