JSON に似たテキストを有効な JSON に変換し、HTML の script 要素や XML の CDATA セクション向けにエスケープ処理を行います。不正な JSON を拒否するのではなく、入力を修復します。不正な入力を拒否する必要がある場合は、厳格なパーサーを使用してください。
Java 8 以降が必要で、実行時の依存関係はありません。
<dependency>
<groupId>org.owasp.json-sanitizer</groupId>
<artifactId>json-sanitizer</artifactId>
<version>1.3.0</version>
</dependency>
import com.google.json.JsonSanitizer;
String json = JsonSanitizer.sanitize("{name:'Ada',}");
// {"name":"Ada"}
はじめにと移行 · 変更履歴 · セキュリティポリシー · お問い合わせ
サニタイザは、実行せずに一般的な JavaScript 風の構文を修復します。 これは JavaScript の評価器ではありません。
| 構文 | ポリシー |
|---|---|
'...' | シングルクォート文字列は JSON 文字列に変換されます。 |
\xAB | 16 進エスケープは JSON の Unicode エスケープに変換されます。 |
\012 | 8 進エスケープは JSON の Unicode エスケープに変換されます。 |
0xAB | 16 進整数リテラルは JSON の 10 進数に変換されます。 |
012 | 8 進整数リテラルは JSON の 10 進数に変換されます。 |
+.5 | 10 進数は JSON のより厳格な形式に強制変換されます。 |
[0,,2] | 配列内の省略要素は null で埋められます。 |
[1,2,3,] | 末尾のカンマは削除されます。 |
{foo:"bar"} | クォートされていないプロパティ名はクォートされます。 |
//comments | JS スタイルの行コメントおよびブロックコメントは削除されます。 |
(...) | グループ化の括弧は削除されます。 |
サニタイザは、欠落した句読点、終了クォート、および不一致または
欠落した閉じ括弧を修正します。入力が空白のみの場合は、
有効な JSON 文字列 null が代入されます。
出力には次の保証があります(JsonSanitizer の Javadoc にも記載されています):
[1]],alert(1) は [1] になります。<script、</script、<!--、--> を含まないため、追加のエンコードなしで HTML の script 要素に埋め込むことができます。]]> を含まないため、追加のエンコードなしで XML の CDATA セクションに埋め込むことができます。(<![CDATA[ 自体はエスケープされません。)JSON.parse が受け入れます。また、括弧で囲んだ後に eval が実行できる JavaScript 式でもあります。ただし、キー __proto__ を繰り返すオブジェクトはそこでは構文エラーになります。どの文字列にも生の U+2028 や U+2029 は含まれません。\t や \n などの短縮形、または \uXXXX)を使用します。トークン間にはスペース、タブ、ラインフィード、キャリッジリターンのみが現れます。その他の文字(U+007F から U+009F を含む)はそのまま現れるため、出力は有効な Unicode であり、XML 1.0 で許可されます。エスケープされた孤立サロゲートは有効な RFC 8259 ですが、I-JSON ではありません。maximumNestingDepth で再度サニタイズすると、変更されずに返されます(Reader または InputStream のオーバーロードを介し、maximumInputLength が出力以上の長さである場合)。括弧のネストはデフォルトで最大 64 レベル(DEFAULT_NESTING_DEPTH)、または maximumNestingDepth パラメータで設定され、1 から 4096 にクランプされます。より深い配列やオブジェクトは null に置き換えられます。1024 桁を超える有効数字を持つ 16 進および 8 進リテラルは 1e999(JavaScript の Infinity)になります。数値のオブジェクトキーはテキスト的に文字列形式に変換されます: double の範囲外の指数は保持され({1e400:0} は "Infinity" ではなく {"1e+400":0} になります)、int の範囲を超えるものは書かれたまま保持されるため({1e2147483648:0} は {"1e2147483648":0} になります)、同じ値のキーが異なることがあります。Reader および InputStream のオーバーロードは、maximumInputLength が指定されない限り最大 4 Mi 文字(DEFAULT_MAXIMUM_INPUT_LENGTH)を受け入れます。このライブラリは Java 8 以降で動作します。
com.google.json。maximumInputLength で設定可能です。
超過すると、出力が書き込まれる前に IOException がスローされます。Reader の
ループは制限を超えて最大 8,192 文字まで読み取る場合があり、UTF-8 デコードでは
さらに先のバイトを読み取る場合があります。これはバイト数やネットワークリクエストの制限ではありません。provided スコープで JSpecify を使用します。解析ツールで
必要とする場合は、ビルドに org.jspecify:jspecify:1.0.1 を追加してください。出力は JSON.parse または JSON パーサーで解析してください。サニタイズはビジネスルールの
検証、アクションの認可、あるいは解析済みの値を innerHTML、SQL、シェルコマンド、
または後続の JavaScript 実行に対して安全にするものではありません。上記の埋め込みに関する
保証は、HTML 属性や任意の出力コンテキストには適用されません。
EvalMinifier は非推奨です。これは JSON.parse 用の JSON ではなく、実行を必要とする
JavaScript 式を生成します。厳格な Content Security Policy は eval をブロックします。
既存の統合のためにのみ保持してください。
JDK 17 以降と、3.x 系の Maven 3.6.3 以降でビルドします:
mvn -B -ntp clean verify
CI は JDK 21 でビルドし、Java 8、11、17、21、25 でテストを実行します。また、Jazzer によるファジングと OSS-Fuzz ビルドチェックも行います。モデル支援レビューについては MODELS.md を、公開手順については リリースガイド を参照してください。 モダナイゼーションアーカイブ は過去の決定と根拠を保存したものであり、現在のセットアップガイダンスではありません。