SAORI/1.0の概要

SAORI/1.0の正しい定義は原典（外部サイト）を参照してください。ここではこのページを読むのに必要な部分だけを簡単にまとめます。

EXECUTE SAORI/1.0
Charset: UTF-8
Sender: 呼び出し元の名前
SecurityLevel: Local
Argument0: 1つ目の引数
Argument1: 2つ目の引数

SAORI/1.0 200 OK
Charset: UTF-8
Result: 結果
Value0: 複数の値を返すときの1つ目

SAORI over DirectSSTP

EXECUTE SAORI/1.0
Module: internal_crypto
Charset: UTF-8
Sender: YAYA
SecurityLevel: Local
HWnd: 1234
Argument0: Digest
Argument1: sha256
Argument2: abc

非同期の呼び出し

内蔵モジュール（名前がinternal_で始まるもの）の関数は、オプション--async=識別子を付けると非同期で動きます。要求を受け付けると、応答はすぐに204で返り、結果はあとで呼び出し元のゴーストへイベントで届きます。
ゴーストなしの呼び出しでは使えません（400 ghost required）。識別子が空なら400（invalid parameter）です。
時間のかかる処理（大きなファイルのハッシュ、パスワードのハッシュ、鍵の導出など）には--asyncを使ってください。
同時に動く非同期の呼び出しは、SSPではCPUの数ほど（2～4）までです。それを超えた分は、前のものが終わるまで順番を待ちます。

引数の数やオプションの名前の誤りは、受付の時点で400になります。引数の中身の誤り（読めない16進など）は、失敗のイベントで届きます。
結果が届く前に呼び出し元のゴーストが終了した場合（SHIORIの再読み込みを含む）、結果は届きません。

送信側の手順

SHIORIなどの送信側は、次の手順でSAORI over DirectSSTPを使います。

使えるかどうかは、最初にGET Versionで確かめてください。

内蔵モジュールの共通規約

SSPが内蔵している、名前がinternal_で始まるモジュールの共通の決まりです。（同じ名前のSAORI DLLと衝突しないように、internal_で始まる名前にしています。）
これらのモジュールはDirect SSTPからだけ呼べます。DLLとしてloadすることはできません。

Argument0: Digest
Argument1: sha256
Argument2: SGVsbG8=
Argument3: --data-in=base64
Argument4: --out=base64

internal_data

データの形式の変換と、圧縮・展開。

Convert

データを別の形式で書き直す（base64⇔16進⇔パーセントエンコード⇔文字列など）。入力は--data-in=、出力は--out=で指定する。

Argument1

data（既定の形式はtext）

オプション

--data-in= / --out=（既定はtext） / --charset=

記述例

Argument0: Convert
Argument1: 48656c6c6f
Argument2: --data-in=hex
Argument3: --out=base64

→ Result: SGVsbG8=

• 2.9.13

Compress

データを圧縮する。

Argument1

方式：gzip / zlib / deflate（ヘッダの無い生のdeflate）

Argument2

data（既定の形式はtext）

オプション

--data-in= / --level=（0～9。省略時はzlibの既定） / --out=（既定はbase64） / --charset=

• 2.9.13

Decompress

圧縮されたデータを展開する。gzipは複数のメンバーをつないだものも読む。
壊れている・途中で切れている・後ろに余計なデータがあるときは400（invalid encoding）。展開した後の大きさも8MBまで（超えると400 too large）。

Argument1

方式：gzip / zlib / deflate / brotli / zstd（brotliとzstdは展開だけ）

Argument2

data（既定の形式はbase64）

オプション

--data-in= / --out=（既定はtext） / --charset=

記述例

Argument0: Decompress
Argument1: gzip
Argument2: H4sIAAAAAAAACvNIzcnJBwCCidH3BQAAAA==

→ Result: Hello

• 2.9.13

internal_crypto

ハッシュ・MAC・共通鍵暗号・鍵の導出・パスワードのハッシュ・データの保護（DPAPI）・ワンタイムパスワード（TOTP）。
Digest / HMACのアルゴリズム名（DeriveKey / TOTPの--digest=も同じ）は次のとおりです。ハイフン・アンダースコアの有無と大文字小文字は区別しません（SHA-256もsha_256もsha256と同じ）。これ以外は400（unsupported algorithm）です。
md5 sha1 sha224 sha256 sha384 sha512 sha512-256 sha3-224 sha3-256 sha3-384 sha3-512 blake2b512 blake2s256

Digest

ハッシュ値を求める。

Argument1

アルゴリズム名

Argument2

data（既定の形式はtext。fileも使える）

オプション

--data-in= / --out=（既定はhex） / --charset=

記述例

Argument0: Digest
Argument1: sha256
Argument2: abc

→ Result: ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad

文字列は既定でUTF-8のバイト列としてハッシュします。Shift_JISのバイト列のハッシュがほしいときは--charset=Shift_JISを付けてください。

• 2.9.13

HMAC

HMACを求める。

Argument1

アルゴリズム名

Argument2

key（既定の形式はtext）

Argument3

data（既定の形式はtext。fileも使える）

オプション

--key-in= / --data-in= / --out=（既定はhex） / --charset=

• 2.9.13

Compare

2つのバイト列を、内容によらず同じ時間で比べる。等しければ1、違えば0（長さが違えば0）。
Webhookの署名の照合など、比べる時間から中身を推測されたくない場面に使う。16進の署名どうしを比べるときは--a-in=hex --b-in=hexにすると、大文字小文字の違いを気にしなくてよい。

Argument1

a（既定の形式はtext）

Argument2

b（既定の形式はtext）

オプション

--a-in= / --b-in= / --charset=

• 2.9.13

Encrypt

共通鍵暗号で暗号化する。

Argument1

アルゴリズム名（共通鍵暗号を参照）

Argument2

key（既定の形式はtext）

Argument3

data（既定の形式はtext）

オプション

--key-in= / --data-in= / --aad=（追加認証データ。認証付き暗号だけ。--aad-in=、既定の形式はtext） / --iv=（--iv-in=、既定の形式はhex） / --pack=none / --out=（既定はbase64） / --charset=

記述例

Argument0: Encrypt
Argument1: aes-256-gcm
Argument2: 000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f
Argument3: secret message
Argument4: --key-in=hex

→ Result: （毎回違うbase64）

• 2.9.13

Decrypt

Encryptの暗号文を復号する。
復号できなければ500（authentication failed）。認証付き暗号では、暗号文・認証タグ・--aad=のどれかが違えばこれになる。CBCではパディングが合わないとき。CTRは間違った鍵でも何かしらの値を返す。

Argument1

アルゴリズム名

Argument2

key（既定の形式はtext）

Argument3

ciphertext（既定の形式はbase64）

オプション

--key-in= / --ciphertext-in= / --aad= / --aad-in= / --iv= / --iv-in= / --pack=none / --out=（既定はtext） / --charset=

--pack=noneのときは--iv=が要ります。--pack=noneでないとき（nonce / IVが暗号文の先頭にあるとき）に--iv=を付けると400（invalid parameter）です。

• 2.9.13

DeriveKey

パスワードなどから、暗号の鍵などに使うバイト列を導出する。方式ごとのパラメータはオプションで指定し、その方式で使わないオプションを書くと400（invalid parameter）。
時間とメモリを使う処理なので、--asyncを推奨。

Argument1

方式：pbkdf2 / hkdf / scrypt / argon2id

Argument2

password（既定の形式はtext）

Argument3

salt（既定の形式はtext）

Argument4

長さ（バイト。1～1024）

オプション

--password-in= / --salt-in= / 下の方式ごとのオプション / --out=（既定はhex） / --charset=

pbkdf2

--digest=（既定はsha256） / --iterations=（既定は600000。1～10000000）

hkdf

--digest=（既定はsha256） / --info=（--info-in=、既定の形式はtext）。passwordが入力の鍵（IKM）で、空にはできない。saltは空でもよい。

scrypt

--n=（既定は8192。2の累乗） / --r=（既定は8） / --p=（既定は10。1～16）。N×r×128バイトが12MiBまで。

argon2id

--iterations=（既定は3。1～1000） / --memory=（KiB。既定は12288。lanes×8～12288） / --lanes=（既定は1。1～16）。saltは8バイト以上、長さは4以上。バージョンは1.3（0x13）。秘密鍵（secret）と関連データ（associated data）は使えない。

範囲の外は400（out of range）です。既定のパラメータは、OWASPの推奨のうちメモリの上限（12MiB）に収まる組み合わせです。

記述例

Argument0: DeriveKey
Argument1: pbkdf2
Argument2: password
Argument3: salt
Argument4: 20
Argument5: --digest=sha1
Argument6: --iterations=4096

→ Result: 4b007901b765489abead49d926f721d065a429c1

• 2.9.13

HashPassword

パスワードを保存用にハッシュし、PHC文字列（方式・パラメータ・ソルト・ハッシュをまとめた1行の文字列）で返す。ソルトは毎回16バイトの乱数、ハッシュは32バイト、パラメータは下の表で固定（OWASPの推奨のうち、メモリの上限12MiBに収まるもの）。
保存した文字列はVerifyPasswordで照合する。--asyncを推奨。

Argument1

password（既定の形式はtext）

オプション

--method=（下の表。既定はargon2id） / --password-in= / --charset=

argon2id

$argon2id$v=19$m=12288,t=3,p=1$ソルト$ハッシュ

scrypt

$scrypt$ln=13,r=8,p=10$ソルト$ハッシュ（ln は N の2を底とする対数）

pbkdf2-sha256

$pbkdf2-sha256$i=600000,l=32$ソルト$ハッシュ

ソルトとハッシュはbase64（パディングなし）です。

• 2.9.13

VerifyPassword

パスワードがPHC文字列と一致するかを調べ、一致すれば1、しなければ0を返す。パラメータはPHC文字列から読む。--asyncを推奨。
HashPasswordの出力のほか、同じ形のものなら他の実装が作った文字列も読める（$argon2id$（v=の無いもの・v=16も可） / $scrypt$ / $pbkdf2-sha1$ / $pbkdf2-sha256$ / $pbkdf2-sha512$）。ただしメモリの上限（12MiB）を超えるパラメータのもの（argon2-cffiの既定の64MiBなど）は400（out of range）で照合できない。
これ以外の方式（bcryptなど）は400（unsupported algorithm）、形の誤りは400（invalid parameter）、パラメータがDeriveKeyの範囲の外なら400（out of range）。

Argument1

password（既定の形式はtext）

Argument2

PHC文字列

オプション

--password-in= / --charset=

• 2.9.13

Protect

データを、OSのデータ保護機能（WindowsのDPAPI）で包む。包んだものは、同じPCの同じユーザー（--scope=machineなら同じPCの全ユーザー）でしかUnprotectできない。
セーブデータに置くトークンなどを、ほかのPCやほかのユーザーにコピーされても読めないようにするためのもので、ゴースト同士を分けるものではない（同じユーザーで動くほかのゴーストやプログラムは戻せる）。

Argument1

data（既定の形式はtext）

オプション

--data-in= / --scope=user（既定） / --scope=machine / --out=（既定はbase64） / --charset=

セーブデータを別のPCへ持っていった場合（SSPのセーブデータ共有、クラウドストレージでの同期、手でのコピーなど）や、Windowsのユーザーを作り直した場合は、Unprotectできなくなります。スクリプトはUnprotectの失敗を「ログインし直してもらう」などとして扱ってください。

• 2.9.13

Unprotect

Protectで包んだデータを元に戻す。戻せなければ500（authentication failed）。

Argument1

data（既定の形式はbase64）

オプション

--data-in= / --out=（既定はtext） / --charset=

• 2.9.13

TOTP

時刻ベースのワンタイムパスワード（RFC 6238。2段階認証のアプリが出す数字）を求める。桁数に満たなければ先頭を0で埋める。

Argument1

key（既定の形式はbase32。認証アプリに登録する秘密鍵の文字列）

オプション

--key-in= / --digits=（既定は6。6～10） / --period=（秒。既定は30。1～86400） / --digest=（既定はsha1。md5は使えない） / --time=（日時。internal_timeの日時の引数と同じ書き方で、ゾーンの無いものはOSのタイムゾーンの時刻。既定は現在時刻） / --charset=

記述例

Argument0: TOTP
Argument1: GEZDGNBVGY3TQOJQGEZDGNBVGY3TQOJQ
Argument2: --time=59
Argument3: --digits=8

→ Result: 94287082

• 2.9.13

internal_random

暗号論的に安全な乱数（OpenSSLのRAND_bytes）。

Bytes

ランダムなバイト列。ソルトやトークンの生成などに。

Argument1

バイト数（1～1024。範囲外は400 out of range）

オプション

--out=（既定はhex）

• 2.9.13

Number

最小以上・最大以下の整数を、偏りなく1つ選ぶ。64ビット符号付き整数の範囲で使える。最小が最大より大きければ400（invalid parameter）。

Argument1

最小

Argument2

最大

• 2.9.13

UUID

UUID（RFC 9562）を小文字の正規の表記（xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）で返す。
バージョン4は全体がランダム。バージョン7は先頭の48ビットが現在時刻（UNIX時刻のミリ秒）で、作った順に並べやすい（同じミリ秒の中での順序は保証しない）。

オプション

--version=4（既定） / --version=7

• 2.9.13

internal_time

日時の整形と計算。日時は内部ではUTCのエポック秒（1970-01-01T00:00:00Zからの秒数。YAYAのGETSECCOUNTと同じ単位）で扱います。

Format

日時を--tz=のゾーンの日時として整形する。曜日・月名は英語で固定（言語・地域の設定によらない）。

Argument1

日時

Argument2

書式（省略時・空のときはiso8601）

オプション

--tz=

書式は次の名前か、%を使った書式です。知らない書式名・知らない%の文字は400（invalid parameter）です。

iso8601 / rfc3339

2026-10-11T21:00:00+09:00。オフセットが0なら末尾はZ。

http

Sun, 11 Oct 2026 12:00:00 GMT。--tz=によらず常にGMT。

epoch / epochms

エポック秒 / エポックミリ秒。

%書式

%Y（西暦4桁） %y（西暦の下2桁） %m（月） %d（日） %H（時） %M（分） %S（秒） %j（年の何日目） %u（曜日 月=1～日=7） %w（曜日 日=0～土=6） %a（Sun） %A（Sunday） %b（Jan） %B（January） %z（+0900） %:z（+09:00） %s（エポック秒） %%（%）。
%以外の文字はそのまま出力する。

記述例

Argument0: Format
Argument1: 0
Argument2: %Y/%m/%d %H:%M (%a)
Argument3: --tz=+09:00

→ Result: 1970/01/01 09:00 (Thu)

• 2.9.13

Add

日時に量を足した日時を、エポック秒で返す。量は負でもよい。
second / minute / hourは経過時間で足す。day以上は--tz=のゾーンの暦で足す（夏時間の切り替えをまたいでも同じ時刻になる）。
月末は丸める（1月31日＋1か月＝2月28日または29日）。

Argument1

日時

Argument2

量（整数）

Argument3

単位：second minute hour day week month year（複数形のdaysなども可）

オプション

--tz=

• 2.9.13

Diff

日時2－日時1を、単位で数えた整数で返す。端数は0の方向へ切り捨てる。
day以上は--tz=のゾーンの暦で数える。たとえば日時2が日付だけ（その日の0時）なら、「あと何日」は--tz=のゾーンで日付が変わる時刻に1つ減る。month / yearは暦の月で数え、Addで足して越えない最大の数を返す（1月31日からは、平年なら2月28日、うるう年なら2月29日の同じ時刻で1か月）。

Argument1

日時1

Argument2

日時2

Argument3

単位（Addと同じ）

オプション

--tz=

記述例

Argument0: Diff
Argument1: 2026-12-20T10:00
Argument2: 2026-12-24
Argument3: day

→ Result: 3（3日と14時間なので3）

カレンダーの日付どうしの差（「今日から何日後か」）がほしいときは、日時1も日付だけにしてください（Formatの%Y-%m-%dで今日の日付を作れます）。

• 2.9.13

internal_text

文字列の処理。

Normalize

文字列をUnicodeの正規化形式にそろえる。半角カナと全角カナ、合成済みの文字と結合文字の並びなど、見た目が同じで符号が違う文字列を比べる前にそろえるのに使う。
OSの機能（Windows Vista以降のNormalizeString）を使う。使えないOSでは500（internal error）。対になっていないサロゲートを含む文字列は400（invalid encoding）。

Argument1

形式：NFC / NFD / NFKC / NFKD（大文字小文字は区別しない。これ以外は400 unsupported algorithm）

Argument2

文字列

記述例

Argument0: Normalize
Argument1: NFKC
Argument2: ｶﾞｲﾄﾞ①

→ Result: ガイド1

• 2.9.13

互換モジュール

SSPは、よく使われていた次のSAORI DLLの互換の機能を内蔵しています。ゴーストがこれらのDLLをloadすると、SSPはDLLを読まずに内蔵の機能に差し替えます（ファイル名で判定します）。
[SSP 2.9.13] これらはDirect SSTPからも、DLL名から.dllを除いた名前（Module: stringなど）で呼べます。引数と戻り値は原作のSAORIのままです。

houchi clipcopy textcopy saori_ip saori_cpuid mciaudio cpuusage httpc string hanayu

• Direct SSTPにはload / unloadが無いので、ゴーストごとに状態を持つもの（mciaudio / httpc / string / hanayu）は、そのゴーストの最初の呼び出しで用意し、ゴーストの終了（SHIORIの再読み込みを含む）で捨てます。DLLとしてloadしたものとは状態を共有しません。
• ゴーストなしの呼び出しでは、ゴーストに依存する処理（httpcの取得・保存とbg、hanayuのshow、mciaudioのload / play / loop / stop）は400（ghost required）になります。
• houchiはloadしたときに働くものなので、Direct SSTPから呼んでも何も起きません。
• Direct SSTPの要求はSSPの主スレッドで処理されるので、httpcの取得はbgを付けて行ってください（付けないと、取得の間SSPの画面が止まります）。