ForHosting KIT · 開発者向けツール

SSH鍵のフィンガープリントを16進数またはBase64で表示

SSHフィンガープリントは、公開鍵を信頼済みの値と照合するための、ハッシュバイトの簡潔な表記です。このツールは、すでに計算されたバイト列を受け取り、小文字の16進数をコロンで区切った形式、またはパディングなしのBase64として一貫して表示します。鍵の解析、ハッシュ方式の選択、ダイジェストの計算は行いません。計算と表示を分離することで、元のバイトを変えずに、スクリプト、管理ツール、文書生成、テストで必要な表記を正確に作成できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

鍵ファイルではなく、生のダイジェストから始めます

この機能は、SSH公開鍵から事前に計算されたハッシュのバイト列を受け取ります。各バイトを元の順序のまま、0から255までの整数として指定してください。たとえば、222、173、190、239で始まるダイジェストは、16進数表示では<code>de:ad:be:ef</code>から始まります。OpenSSHの鍵行、PEMブロック、証明書、またはダイジェストのように見える文字列は受け付けません。それらの解析とハッシュ計算は、整形前に完了している必要があります。この分離が必要なのは、任意の文字列だけから鍵の符号化方式やハッシュアルゴリズムを安全に推測できないためです。また、同じバイト列から常に同じ文字列が得られるので、テストも容易になります。先頭のゼロを含むすべてのバイトを保持してください。1バイトでも削除すると、16進数とBase64の両方の結果が変わります。空の配列と128バイトを超える入力は、無効な値や誤って大きなデータがフィンガープリントとして扱われないよう拒否されます。

受け取り側が要求する表示形式を選びます

ツール、資産台帳、運用手順が、1バイトにつき小文字の16進数字2桁をコロンで区切った表記を要求する場合は、<code>hex-colon</code>を選択してください。各バイトの桁数は維持され、ゼロは<code>00</code>、15は<code>0f</code>、255は<code>ff</code>と表示されます。現代的なSSHフィンガープリントで一般的な短い表記が必要な場合は、<code>base64</code>を選択してください。Base64の結果では、SSHの表示慣行に合わせ、末尾の等号によるパディングを省略します。どちらの選択肢も表示だけを変更し、バイトの変更、逆順化、切り詰め、再ハッシュは行いません。応答には<code>fingerprint</code>と<code>format</code>が含まれるため、後続処理で値と表記を一緒に保持できます。形式名は厳密に検証され、誤記、未対応の名前、大文字と小文字の違いは入力エラーになります。もっともらしい既定値を勝手に選ばないため、誤った形式の値が正しいフィンガープリントとして使われることを防げます。

安全に照合し、この機能の範囲を理解します

整形済みの値は、元のダイジェストがどのように得られたかを確認してから使用してください。一致に意味があるのは、双方が同じ公開鍵の正規バイト列に同じハッシュアルゴリズムを適用した場合です。表示形式の変換だけでは、その条件を証明できず、ダイジェストを強化したりホストを認証したりすることもできません。周辺のプロトコルや画面がアルゴリズムを示さない場合は、別途記録してください。自動処理で比較するときは、記号から形式を推測せず、元のバイトから双方を正規化するか、明示的な形式を要求します。この機能は、端末メッセージ、配備レポート、ホスト台帳、承認画面、回帰テストに安定した出力を提供します。ネットワークには接続せず、鍵やフィンガープリントを保存しません。ブラウザー版はローカルで動作し、APIによる自動処理は1回あたり$0.002です。不正なバイトや未対応形式は明確に失敗します。不一致があれば処理を止め、信頼できる経路で情報源をご確認ください。

活用例

ホスト確認画面を準備する

新しいSSHホストを承認する前に、担当者が確認する表記とまったく同じ形式でダイジェストを表示します。

資産台帳の出力を統一する

上流のスキャナーが生のハッシュバイトを返す場合でも、フィンガープリントの表示を統一できます。

再現可能なテストデータを作る

OSのコマンドや地域設定に依存せず、SSHツール向けの安定した期待値を生成します。

よくある質問

SSH公開鍵のハッシュも計算しますか？

いいえ。事前に計算された生のハッシュバイトを整形するだけです。鍵の解析とダイジェスト計算は先に行ってください。

Base64形式では何が返されますか？

元のバイト順を保ち、末尾の等号によるパディングを除いた標準Base64アルファベットの文字列を返します。

16進数の結果では先頭のゼロが保持されますか？

はい。各バイトは必ず小文字の16進数字2桁で表され、隣り合うバイトはコロンで区切られます。

有効なバイト値の範囲はどこまでですか？

各要素は0から255までの整数で、配列には1個以上128個以下の要素が必要です。

別の形式を指定するとどうなりますか？

無効な入力として失敗します。対応する値は<code>hex-colon</code>と<code>base64</code>だけです。

APIでの整形料金はいくらですか？

APIリクエスト1回につき$0.002です。同じ決定論的な処理をブラウザーでも実行できます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/security/ssh-key-fingerprint-format

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/security/ssh-key-fingerprint-format \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hash_bytes":[222,173,190,239,0,1,127,128],"format":"hex-colon"}'

const res = await fetch("https://api.kit.forhosting.com/security/ssh-key-fingerprint-format", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "hash_bytes": [
      222,
      173,
      190,
      239,
      0,
      1,
      127,
      128
    ],
    "format": "hex-colon"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/security/ssh-key-fingerprint-format",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "hash_bytes": [
        222,
        173,
        190,
        239,
        0,
        1,
        127,
        128
    ],
    "format": "hex-colon"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/security/ssh-key-fingerprint-format", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"hash_bytes":[222,173,190,239,0,1,127,128],"format":"hex-colon"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"hash_bytes":[222,173,190,239,0,1,127,128],"format":"hex-colon"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/security/ssh-key-fingerprint-format", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "hash_bytes": [
    222,
    173,
    190,
    239,
    0,
    1,
    127,
    128
  ],
  "format": "hex-colon"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "security.ssh_key_fingerprint_format",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

max_items 128

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →