Go サンプルプログラム

概要

このサンプルクライアントは以下の 6 パターンに対応しています。

• 新規注文（後払い）× メール認証 / ファイル認証 / DNS 認証
• 再発行 × メール認証 / ファイル認証 / DNS 認証

認証の承認待ち中は自動的にポーリング（デフォルト 30 秒ごと）し、 証明書が発行されると自動でダウンロードします。
途中で中断しても、ステートファイル（ssl-state.json）から処理を再開できます。

ダウンロード

ソースコードをダウンロードして、Go がインストールされた環境で実行してください。

セットアップ

外部ライブラリは不要です。go run ssl-client.go でそのまま実行できます。

# Go バージョン確認（1.20 以上）
go version

# ヘルプの表示
go run ssl-client.go help

API キーは マイページ で取得できます。
毎回指定するのが面倒な場合は環境変数 SSL_API_KEY に設定しておくと便利です。

# Linux / macOS
export SSL_API_KEY=your_api_key_here

# Windows PowerShell
$env:SSL_API_KEY = "your_api_key_here"

新規注文

order コマンドで後払いの新規注文を作成します。
注文後、CSR と秘密鍵が自動生成されてカレントディレクトリに保存されます。

go run ssl-client.go order \
  -api-key      YOUR_API_KEY \
  -product      RapidSSL \
  -years        1 \
  -domain       www.example.com \
  -dcv          email \
  -dcv-email    admin@example.com \
  -corp-name    "株式会社〇〇" \
  -corp-name-alph "Example Corp" \
  -name1        田中 \
  -name2        太郎 \
  -name-alph1   Tanaka \
  -name-alph2   Taro \
  -tel          03-1234-5678 \
  -email        tanaka@example.com \
  -invoice-email tanaka@example.com \
  -post         1000001 \
  -addr1        東京都 \
  -addr2        千代田区 \
  -addr3        "〇〇1-1"

go run ssl-client.go order \
  -api-key      YOUR_API_KEY \
  -product      RapidSSL \
  -years        1 \
  -domain       www.example.com \
  -dcv          file \
  -corp-name    "株式会社〇〇" \
  -corp-name-alph "Example Corp" \
  -name1        田中 \
  -name2        太郎 \
  -name-alph1   Tanaka \
  -name-alph2   Taro \
  -tel          03-1234-5678 \
  -email        tanaka@example.com \
  -post         1000001 \
  -addr1        東京都 \
  -addr2        千代田区 \
  -addr3        "〇〇1-1"

go run ssl-client.go order \
  -api-key      YOUR_API_KEY \
  -product      RapidSSL \
  -years        1 \
  -domain       www.example.com \
  -dcv          dns \
  -dns-zone-id  Z0123456789ABCDEFGHIJ \
  -corp-name    "株式会社〇〇" \
  -corp-name-alph "Example Corp" \
  -name1        田中 \
  -name2        太郎 \
  -name-alph1   Tanaka \
  -name-alph2   Taro \
  -tel          03-1234-5678 \
  -email        tanaka@example.com \
  -post         1000001 \
  -addr1        東京都 \
  -addr2        千代田区 \
  -addr3        "〇〇1-1"

名前  : _dnsauth.www.example.com
タイプ: TXT
値    : <DCV トークン>
TTL   : 60

go run ssl-client.go order \
  -api-key      YOUR_API_KEY \
  -product      RapidSSL \
  -years        1 \
  -domain       www.example.com \
  -dcv          dns \
  -corp-name    "株式会社〇〇" \
  -name1        田中 \
  -name2        太郎 \
  -tel          03-1234-5678 \
  -email        tanaka@example.com

━━ DNS 認証（手動設定）━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  名前  : _dnsauth.www.example.com
  タイプ: TXT
  値    : _abcdefghijklmnopqrstuvwxyz01234
  TTL   : 60
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  DNS レコードを設定したら Enter を押してください ...

再発行

reissue コマンドで発行済み注文の再発行を行います。
新しい CSR・秘密鍵が自動生成されます（ssl-client-reissue.key / ssl-client-reissue.csr）。

go run ssl-client.go reissue \
  -api-key      YOUR_API_KEY \
  -order-id     12345 \
  -domain       www.example.com \
  -dcv          email \
  -dcv-email    admin@example.com

go run ssl-client.go reissue \
  -api-key      YOUR_API_KEY \
  -order-id     12345 \
  -domain       www.example.com \
  -dcv          file

go run ssl-client.go reissue \
  -api-key      YOUR_API_KEY \
  -order-id     12345 \
  -domain       www.example.com \
  -dcv          dns \
  -dns-zone-id  Z0123456789ABCDEFGHIJ

go run ssl-client.go reissue \
  -api-key      YOUR_API_KEY \
  -order-id     12345 \
  -domain       www.example.com \
  -dcv          dns

途中再開

処理の途中でCtrl+C などで中断しても、ステートファイル（ssl-state.json）に状態が保存されています。
同じコマンドをもう一度実行するだけで、中断した時点から自動的に再開します。

# 例: 中断した新規注文（メール認証）を再開する場合
# ssl-state.json が存在する限り、フラグを省略しても再開できます
go run ssl-client.go order -api-key YOUR_API_KEY

ステートファイルの内容（例）：

{
  "action": "order",
  "step": "pending-dcv",
  "order_id": 12345,
  "dcv": "file",
  "token": "_abcdefghijklmnopqrstuvwxyz01234",
  "domain": "www.example.com",
  "file_auth_path": ".well-known/pki-validation/fileauth.txt"
}

処理完了後は step が completed に更新されます。
別のドメインの注文を始める場合は、ステートファイルを削除または別名で指定してください。

# ステートファイルを指定して別の注文を管理
go run ssl-client.go order -api-key YOUR_API_KEY -domain other.example.com \
  -state-file ssl-state-other.json ...

オプション一覧

order フラグ

reissue フラグ

status / download フラグ