はじめに
プリザンターのAPIやアクセス制御を読むときは、コントローラーやモデルだけでなく、コードを生成するテンプレートにも目を向ける必要があります。
今回は、ユーザー情報API、添付ファイル、情報公開、項目の読取り制限に関する4件の脆弱性を題材に、問題につながる実装を追います。特に、通常のAPIでは除外した項目が別形式のAPIには残る理由と、画面では隠れている値が別の出力先に現れる理由を整理します。
ここで示す修正方針と改善コードはソース解析に基づく設計案です。既存コードの引用にはファイル名とパーマリンクを付け、改善案にはその旨を記載します。新設する型やメソッドを含む疑似コードは、変更する責務を説明するためのもので、そのまま適用するパッチではありません。メーカーの修正版の実装を説明するものではなく、利用環境への対策は公式の修正版・案内に従う前提です。攻撃リクエストの再現手順は扱いません。
解析対象は、指定されたローカルチェックアウトのバージョン1.5.9.1です。コード引用のリンクは対象コミットに固定しています。以下は静的解析の結果であり、各経路を実行して再現した結果ではありません。
この4件は、2026年11月17日にリリースされた 1.5.10.0 で修正されています。プリザンター公式のセキュリティ情報(2026年11月17日公開)に、次の4件が掲載されています。
| 公式の項目名 | 対象バージョン |
|---|---|
| APIにおけるAPIキー等の情報漏えいの脆弱性 | 1.2.24.0〜1.5.9.1 |
| APIの添付ファイルの処理におけるパストラバーサルの脆弱性 | 1.5.9.1以前のすべて |
| 情報公開機能における非公開情報の漏えいの脆弱性 | 1.5.9.1以前のすべて |
| 項目のアクセス制御で読取りを制限した項目の値が参照できる脆弱性 | 1.5.9.1以前のすべて |
修正版は 1.5.10.0 です(公式リリース記録)。この記事の解析対象は 1.5.9.1 です。該当するバージョンを利用している場合は、1.5.10.0 以降への更新を検討してください。
4件の問題と実装上の境界
| 問題 | 本来確認する境界 | コード上の問題 |
|---|---|---|
| ユーザー情報APIからの秘密情報漏えい | APIに出せる項目か | 通常形式の除外が汎用形式に引き継がれない |
| 添付ファイルのパストラバーサル | サーバーが管理する一時ファイルか | 入力された添付情報を読み取りパスに使う |
| 情報公開からの非公開情報漏えい | 公開サイトが提示してよい選択肢か | 選択肢にないIDの名前を追加取得する |
| 読取り制限を設定した項目の漏えい | そのユーザーがそのレコードの項目を読めるか | レコード条件の判定がなく、出力先ごとの確認も揃わない |
いずれも、入口でログインやサイト権限を確認するだけでは防げない問題です。最終的に返す項目、読み取るファイル、返す選択肢まで条件を結び付けて確認します。
コード生成の仕組みを先に確認する
プリザンターでは、Implem.Pleasanter/App_Data/Definitions/Definition_Code/ に、生成条件を記述したJSONと、生成するコードの本文を記述したテキストがあります。
Implem.CodeDefiner の Creators.Create() は、テンプレート内の子テンプレートを展開します。RepeatType が Column の定義は列単位、Table の定義はテーブル単位で処理されます。
生成条件の Exclude は、実行時のアクセス制御とは別です。あるメソッドに特定の列の処理を生成しない指定であって、別メソッドや別出力経路にも適用される保証はありません。この違いが1件目に直結します。
ユーザー情報APIでは秘密項目の除外が経路ごとに異なる
通常形式ではAPIキーを生成対象から外している
Model_GetByApi_Body.txt は、通常形式のAPIモデルを組み立てます。列ごとの代入処理を作るのが Model_GetByApi_ColumnCases です。
その生成条件には、次の除外があります。
CommentsApiKeyCompletionTimeApiAllowIpAddressRange
つまり、APIキーを通常の返却項目から外す意図はコードにあります。ただし、ここだけ確認して「APIからは返らない」と判断すると、別経路を見落とします。
汎用形式は別の変換メソッドを使う
UserUtilities.GetByApi() は、View.ApiDataType が KeyValues の場合、通常の UserApiModel ではなく GridData.KeyValues() で返却データを作ります。
この経路では、View.GridColumns で選ばれた列を、UserModel.ToApiValue() などの汎用変換へ渡します。生成元は GridData_KeyValues_Body.txt と Model_ToApiValueColumnCases です。
ところが、汎用変換側の生成条件には ApiKey や SecretKey の除外がありません。
汎用変換にも項目権限の確認自体はあります。しかし、対象版の Users_ApiKey.json や Users_SecretKey.json には、秘密項目を保護する ReadAccessControl の定義がありません。
通常形式の生成条件で除外しても、別形式の変換処理と列定義が同じ制約を持っていなければ、秘密項目が返却対象に残ります。 二段階認証コードや秘密鍵については、通常の UserApiModel にもプロパティがあり、APIキーとすべて同じ経路だと考えないことも大切です。
修正を考えるなら、秘密情報の分類を列定義に持たせ、すべてのAPI出力経路で返却可否を判断できる形にします。個別のDTO、つまりAPIの返却用データ型から項目を削除するだけでは、汎用出力経路の対策が残ります。
改善案はAPIの返却方針を共通化する
通常形式と汎用形式の生成条件を並べると、何が揃っていないのかが分かります。以下はそれぞれの定義からの引用です。
{
"Id": "Model_GetByApi_ColumnCases",
"RepeatType": "Column",
"Indent": "5",
"Separator": "\\r\\n",
"NotCalc": "1",
"Select": "1",
"Exclude": "Comments,ApiKey,CompletionTime,ApiAllowIpAddressRange"
}
{
"Id": "Model_ToApiValueColumnCases",
"RepeatType": "Column",
"Indent": "4",
"Separator": "\\r\\n",
"Exclude": "FirstAndLastNameOrder,UserSettings,MailAddresses,PasswordHistries,"
}
通常形式の Exclude を増やすだけでは、汎用形式の switch は変わりません。また、汎用変換に権限チェックがないわけでもありません。実際には次のチェックがあります。
public object ToApiValue(Context context, SiteSettings ss, Column column, List<string> mine)
{
if (!ss.ReadColumnAccessControls.Allowed(
context: context,
ss: ss,
column: column,
mine: mine))
{
return string.Empty;
}
switch (column.Name)
{
ここで確認しているのは、サイト設定の項目読取り権限です。「APIで絶対に返さない秘密項目」という出力方針が、そのままこの判定に組み込まれているわけではありません。設定がないことを許可として扱う既定動作と組み合わさると、秘密値も通常の項目と同じように変換されます。
例えば、ユーザーAPI専用の返却可能項目を明示し、クライアントが指定した列との積集合を取る設計にします。次は方針を示すC#の改善例です。例示した3項目以外は返さないため、実装時には既存APIの契約に従って許可項目を定義します。
private static readonly HashSet<string> UserApiReadableColumns =
new(StringComparer.Ordinal)
{
"UserId",
"Name",
"DeptId"
};
private static bool IsUserApiOutputColumn(string columnName)
{
return UserApiReadableColumns.Contains(columnName);
}
この判定はユーザーAPIの通常形式・汎用形式・表示値形式のすべてに適用します。SQLの取得列を組む段階で秘密項目を外し、応答を組む段階でも同じ方針を適用すると、取得済みモデルからの混入も防げます。ここで許可された列に対して、さらに通常の読取り権限を確認します。
列名だけで全テーブル共通の禁止リストを作ると、別テーブルの同名列まで巻き込むことがあります。共通メタデータにする場合は、テーブルと列を特定できる識別子を使い、API出力不可を役割に関係なく優先する方針にします。
なお、ReadAccessControl に高い権限を要求する回避策と、APIへ一切返さない設計は同じではありません。前者は指定された権限を持つ主体なら通り得ます。サービス管理者を含め誰にも返さない項目なら、出力不可という独立した条件が必要です。
添付ファイルでは入力データが読み取りパスになる
Base64がない場合にサーバー上のファイルを読む
Attachment.GetBin() は、Base64 または Base64Binary があればデコードします。どちらもなければ、次の3要素でパスを組み立ててファイルを読みます。
- 一時保存ディレクトリ
- 添付情報の
Guid - 添付情報の
NameまたはFileName
Path.Combine() はパスを組み立てる処理です。組み立てた結果が許可ディレクトリ内にあることや、正規のアップロードファイルであることまでは保証しません。
ファイル名の検証があるだけでは足りない
Attachment.OnDeserialized() にはファイル名の検証があります。ただし、Base64の両項目がないと、その前で処理を抜けます。
一方、Added が立った添付情報は、後続のハッシュ計算や保存処理でファイル読み取りに進みます。DB保存の経路では GetBin()、解析対象の外部保存経路では WriteToLocal() がファイルを開きます。
APIの添付情報をモデルへ取り込む処理にも生成元があります。Model_SetByApi_Body.txt は、data.AttachmentsHash の内容を添付コレクションへ反映します。
直接の読み取り処理は共通クラスの Attachment.cs にあります。生成されたモデルの入力処理と、共通クラスの読み取り処理をつないで確認する必要があります。
修正方針としては、クライアントから受け取る添付情報と、サーバーが管理する一時ファイル情報を分けます。サーバーが発行した識別子から保存場所を解決し、アップロード所有者を確認します。パスを扱う箇所では正規化後の保存範囲も確認し、絶対パスや親ディレクトリへの移動を受け付けないようにします。
改善案は添付要求とサーバーの管理情報を分ける
問題の中心は、次の読み取りです。
public byte[] GetBin(Context context = null)
{
var bin = Base64 ?? Base64Binary;
if(bin is null)
return Files.Bytes(Path.Combine(Directories.Temp(), Guid, Name ?? FileName));
return System.Convert.FromBase64String(bin);
}
Guid というフィールド名でも、その値がサーバー発行の正規な識別子とは限りません。Added も入力可能なフィールドであるため、「追加済みの添付を処理している」という前提を入力だけから確定できません。
改善するなら、受け取るデータを「新しいバイナリ」「アップロード済みの一時ファイル」「既存添付への操作」に分けます。次は責務を示す疑似コードです。LoadForUpdate()、AssertUploadOwnerAndTenant()、OpenManagedTemporaryFile() は新設する処理を表します。
if (request.Base64 is not null)
{
// 上限検証、サーバー側での識別子発行、一時保存を行う。
return CreateNewUpload(context, request.Base64, request.DisplayName);
}
// requestにはパスではなく、サーバーが発行したUploadIdを渡す。
var upload = uploadRepository.LoadForUpdate(request.UploadId);
AssertUploadOwnerAndTenant(context, upload);
AssertNotExpiredOrConsumed(upload);
// パス、サイズ、コンテンツ種別はサーバー側の管理情報から取得する。
using var stream = OpenManagedTemporaryFile(upload);
return AttachToAuthorizedRecord(context, record, upload, stream);
既存添付を残す、削除する、リンクする操作も、対象レコードとの関係をサーバー側で検証します。GUIDの書式検査だけでは、別ユーザーの正しいGUIDを渡すケースを拒否できません。
パスを扱う共通処理にも防御を置きます。例えば、次は管理済みの相対パスが一時保存先の範囲内にあることを確認するC#の改善例です。
static string ResolveWithinRoot(string root, string managedRelativePath)
{
if (string.IsNullOrWhiteSpace(managedRelativePath)
|| Path.IsPathRooted(managedRelativePath))
{
throw new InvalidDataException("Invalid temporary path.");
}
var fullRoot = Path.GetFullPath(root);
var candidate = Path.GetFullPath(Path.Combine(fullRoot, managedRelativePath));
var relative = Path.GetRelativePath(fullRoot, candidate);
if (relative == "."
|| relative == ".."
|| relative.StartsWith(".." + Path.DirectorySeparatorChar,
StringComparison.Ordinal)
|| relative.StartsWith(".." + Path.AltDirectorySeparatorChar,
StringComparison.Ordinal)
|| Path.IsPathRooted(relative))
{
throw new InvalidDataException("Temporary path escaped its root.");
}
return candidate;
}
StartsWith(root) だけだと、保存先と名前の先頭が一致する別ディレクトリまで通すことがあります。上の例は相対化した結果のディレクトリ境界を見ます。ただし、これは文字列としてのパス範囲の確認です。シンボリックリンクやWindowsのジャンクションなどの再解析ポイントを経由した脱出、検証後のファイル差替えまでは防ぎません。一時保存ツリーを信頼できる主体だけが書き込めるようにし、リンクの扱いとファイルを開くまでの整合性も別途保証します。
この関数を追加しても、アップロード所有者や有効期限の検証は残ります。また、検証したパスを返した後に元の入力値でパスを組み直すと対策が無効になるため、後段は確定したパスや開いたストリームを受け取る形に揃えます。
情報公開では選択肢の補完処理が公開範囲を越える
公開サイトには、ログインしていない人でも利用する選択肢取得処理があります。PublishesController には AllowAnonymous が指定され、選択肢処理を DropDowns に渡します。
ここで注目するのは、選択した値の表示名を補完する SelectSearchDropDownResponse() です。
検索型の選択肢で、渡されたIDが現在の ChoiceHash に存在しない場合、ユーザーなら SiteInfo.User()、その他なら SiteInfo.Name() で名前を取得し、選択肢へ追加します。さらに、選択値がなお見つからない場合には選択肢の再取得も行います。
選択済みの値が検索ページに含まれていない場合など、表示名を補う機能自体には用途があります。しかし、公開サイトでは「送信されたIDが存在するか」に加えて、「この公開サイトの選択肢として返してよいIDか」を確認します。
また、リンク先を読む SiteSettings.LinkHash() では、公開時は通常のレコード閲覧権限による絞り込みを外しています。
公開サイトでは、非公開サイトの値を選択肢として利用する場合があります。そのため、この分岐だけを悪い実装と決め付けることはできません。選択肢としての限定公開を認めるなら、補完や再取得にも同じ限定範囲を適用する必要があります。
名前が取得できることと、公開してよいことは別です。修正時には、画面に表示する候補、検索、選択後の補完が、同じ条件で選択肢を解決するようにします。
改善案はページングと公開権限を分離する
補完処理のユーザー分岐を抜き出すと、返却範囲を越える理由が見えます。
case Column.Types.User:
selected
.Select(userId => SiteInfo.User(
context: context,
userId: userId.ToInt()))
.Where(o => !o.Anonymous())
.ForEach(user =>
column.ChoiceHash.AddIfNotConainsKey(
user.Id.ToString(),
new Choice(
value: user.Id.ToString(),
text: user.Name)));
break;
SiteInfo.User() でユーザーを見つけ、匿名ユーザーではないことを確認しています。しかし、この条件は「公開サイトのこの項目の候補として許可されているか」を確認していません。同じテナントのユーザーであっても、公開対象とは限りません。
ここを単純に「現在の ChoiceHash にないIDはすべて拒否する」と変えると、検索の次ページにある正規の選択肢や、初期ロード時にまだ取得していない選択済み項目まで壊す可能性があります。現在のページに載っているかと、候補全体として許可されるかを分けます。
検索と補完が同じ許可済み候補クエリを使う設計なら、補完処理は次のように書けます。BuildAllowedChoiceQuery() は新設する共通処理で、テナント・公開元サイト・項目・リンク設定・候補フィルターをサーバー側で確定する疑似コードです。
var allowedChoices = BuildAllowedChoiceQuery(
context, publishedSite, column, authorizedParentValues);
// selectedIdsは絞り込みにだけ使い、許可範囲そのものには使わない。
var selectedChoices = allowedChoices
.Where(choice => selectedIds.Contains(choice.Id))
.Select(choice => new { choice.Id, choice.DisplayText })
.ToList();
if (selectedChoices.Count != selectedIds.Distinct().Count())
{
return GenericChoiceNotFound();
}
return RenderSelectedChoices(selectedChoices);
authorizedParentValues はリクエストの親IDをそのまま信用する値ではなく、関連付けと権限を確認した値です。親子条件がある選択肢では、親IDを変えて候補範囲を広げられないようにします。
重要なのは、名前取得後に表示だけを隠すのではなく、候補を読む問い合わせ自体に許可条件を残すことです。存在するが不許可のIDと、存在しないIDを応答で区別すると存在確認の手掛かりにもなるため、候補が解決できない場合の応答は揃えます。
一度表示した選択肢をキャッシュするなら、公開元サイト・項目・親条件・設定の変更を区別する必要があります。ページング中の辞書を権限の根拠にせず、許可候補の定義を検索と補完で共有します。
項目権限では候補の抽出と最終判定が混ざる
レコード情報がない状態では利用者条件を確定できない
通常形式の ResultModel.GetByApi() は、ss.ReadableColumns() が返す列をAPIモデルへコピーします。この処理の生成元が Model_GetByApi_Body.txt です。
ReadableColumns() は、CanRead() に mine: null を渡しています。mine は、そのユーザーが対象レコードの担当者・作成者などに該当するかを判定するための情報です。
ColumnAccessControl.Allowed() のレコード利用者条件には、次の判定があります。
RecordUsers?.Any(o => mine == null || mine?.Contains(o) == true) == true
先行する権限条件で結果が確定しない場合、この分岐では、レコード利用者条件があり mine が null なら許可されます。
これは候補列を広めに選ぶ処理としてなら理解できます。しかし、その結果を最終的な読取り許可として扱い、実レコードの Mine(context) を使う判定を省くと、条件に合わないレコードの値まで返します。
汎用形式の生成テンプレート GridData_KeyValues_Body.txt は、実レコードの Mine(context) を変換処理へ渡しています。通常形式と汎用形式で、使う情報の粒度が揃っていません。
修正時はキャッシュにも注意します。Column.CanRead() は判定結果を保持するため、レコードを切り替える際のキャッシュ無効化や、レコード単位での再判定が必要です。候補抽出時の許可結果を、後段でそのまま使わないようにします。
改善案は候補列の判定と値の返却判定を分ける
APIの生成元には、候補の列を取得してから値を代入する処理があります。問題は、列一覧を取得したことが、そのレコードの項目を読めるという最終判定になっている点です。
public #ModelName#ApiModel GetByApi(Context context, SiteSettings ss<!--Model_GetByApi_GetMailAddressesParameter-->)
{
var data = new #ModelName#ApiModel()
{
ApiVersion = context.ApiVersion
};
ss.ReadableColumns(context: context, noJoined: true).ForEach(column =>
{
switch (column.ColumnName)
{
改善するなら、候補列を得た後、対象レコードの利用者情報で再判定します。次は Model_GetByApi_Body.txt に反映する構造を示す疑似コードです。ApiOutputCandidates() は候補抽出と秘密項目の除外を担当する新設処理で、読取り許可を確定する関数ではありません。
var mine = Mine(context: context);
foreach (var column in ss.ApiOutputCandidates(context))
{
if (!column.CanRead(
context: context,
ss: ss,
mine: mine,
noCache: true))
{
continue;
}
// ここで既存の列別switchやdata.Value()を生成する。
// ItemTitleなどの追加値も、参照元の権限を別途確認する。
}
既存の ReadableColumns() を残し、その直後に最終判定を追加する方法も考えられます。ただし、その関数が候補抽出を兼ねている限り、mine: null の意味を一律に拒否へ変えると、取得後に許可できるはずの列まで候補から落ちる可能性があります。候補を選ぶ処理と、値を返す許可を決める処理は別の名前と契約に分ける方が明確です。
最終判定専用の処理では、レコード情報がないことを許可に変換しません。例えば、レコード利用者条件の該当判定は次の形になります。これは条件分岐全体の置換ではなく、既存の組織・グループ・ユーザー・権限種別による判定を残したうえでの、レコード利用者条件の改善例です。
var matchesRecordUser = mine is not null
&& RecordUsers?.Any(role => mine.Contains(role)) == true;
キャッシュを残したまま引数だけ直しても不十分
CanRead() の次の部分では、CanReadCache が存在すると mine を使う再計算が行われません。
else if (CanReadCache == null)
{
var columnAccessControl = ss.ReadColumnAccessControls?.FirstOrDefault(o => o.ColumnName == ColumnName)
?? new ColumnAccessControl(ss, this, "Read");
CanReadCache = columnAccessControl.Allowed(
context: context,
ss: ss,
mine: mine);
ss.ColumnAccessControlCaches.AddIfNotConainsKey(ColumnName, this);
}
return CanReadCache == true;
}
例えば、同じユーザーがレコードAの担当者でレコードBの担当者ではない場合、同じ列の判定でも結果は異なります。候補抽出で保存された許可や、レコードAの許可をレコードBで使えば、mine を正しく渡しても結果が変わりません。
上の改善案が noCache: true を使うのは、この使い回しを避けるためです。これは実装しやすい案ですが、性能との兼合いがあります。キャッシュを使うなら、判定に影響するユーザー、テナント、サイト、レコード、列、設定の版などを適切に区別するか、1レコードの出力処理にだけ寿命を限定します。
既存コードには ClearColumnAccessControlCaches() もあります。この関数は列のキャッシュだけでなく、モデルの MineCache も消します。キャッシュの寿命を変えるときは、列側とモデル側の両方を確認します。
JSONのヘッダーだけ確認しても本文は守れない
GridData.Json() には、エクスポートのヘッダーに含める列の権限確認があります。一方、本文は JsonStacks() から ResultExportModel などを作ります。
Model_Export_Body.txt の Set() は、取得した DataRow の各列を走査して値を転記します。この転記処理には、レコードごとの項目権限の確認がありません。
項目名をヘッダーから隠すことと、値を本文へ出さないことは別です。JSON本文を組み立てる時点でも判定します。
合成列とカスタムデザインは参照元の権限を確認する
一覧の「タイトルと内容」は、TitleBody という合成値です。合成列自身の権限だけを確認しても、その中に含める Body の制限は保証されません。出力先の列だけでなく、合成元の各項目を確認します。
カスタムデザインも同様です。生成元の Model_Utilities_TdValue_Body.txt は、デザイン内に含まれる列を列挙し、各値を GridText() に変換して文字列へ埋め込みます。ここには、参照した各項目のレコード単位の読取り判定がありません。
metaタグと検索索引も値の出力先として扱う
編集画面の生成テンプレート Model_Utilities_EditorItem_Body.txt は、HTML生成処理にモデルの Body を直接渡します。その値は HtmlTemplates のdescription用metaタグに使われます。フォームの本文欄を隠しても、HTMLの別の場所へ値が出れば読取り制限になりません。
Model_FullText_Body.txt は、編集対象の列から全文検索用の文字列を組み立てます。この生成経路にも、項目の読取り制限に応じた除外処理がありません。
共有の検索索引に対して、更新したユーザーの権限だけで収録内容を決める修正も適切ではありません。読取り制限のある項目を共通索引から除外するか、検索時に権限を適用できる構造にします。既存索引に制限対象の値が残る場合は、索引の再作成も対策範囲に入ります。
出力経路ごとに修正する位置を決める
APIで最終判定を直しても、モデルのプロパティを直接使う出力先は保護されません。それぞれの経路について、判定する場所と対象を決めます。
| 出力先 | まずい実装 | 改善する位置と条件 |
|---|---|---|
| JSON本文 | DB列を出力モデルへそのまま代入 | レコード利用者情報を持つ状態で、代入前に列の読取り可否を判定 |
| 合成列 |
TitleBody の許可だけで本文も含める |
Title と Body の許可を別々に確認してから合成 |
| カスタムデザイン | 参照列の値を直接 GridText() に渡す |
埋め込む各参照列を判定し、不許可なら値の取得・整形を省く |
| metaタグ | フォームとは別に未加工の Body を渡す |
meta用に許可された値だけを渡し、不許可時は非機密の既定文言にする |
| 検索索引 | 制限項目を他の値と混ぜて共通索引へ格納 | 共通索引から除外するか、項目権限を適用できる索引と検索処理へ変更 |
例えば、カスタムデザインの生成元には次の転記があります。
case "Description":
value = #modelName#Model.GetDescription(columnName: column.Name).GridText(
context: context,
column: column);
break;
GridText() は表示形式への変換です。変換できることを読取り許可の代わりにせず、各参照列の値を取り出す前に column.CanRead(..., mine, noCache: true) などの最終判定を置きます。
metaタグには、さらにフォールバックの問題があります。HtmlTemplates.Description() は、渡された body が空なら ss.Body、それも空なら全体設定を使います。
private static string Description(SiteSettings ss, string body)
{
return WebUtility.HtmlEncode(Strings.CoalesceEmpty(
body,
ss.Body,
Parameters.General.HtmlHeadDescription)
.SplitReturn()
.Select(o => o.Trim())
.Where(o => !o.IsNullOrEmpty())
.Join(" "));
}
そのため、「不許可なら body に空文字列を渡す」だけでは、別の本文がdescriptionへ現れる可能性があります。空であることと、アクセス制御により使用禁止であることを同じ値で表さず、metaへの利用可否を明示的に渡す設計にします。HTMLエンコードは文字の解釈を制御する処理なので、エンコードした秘密情報が漏えいしなくなるわけではありません。
検索索引も、検索結果の本文を隠すだけでは足りません。制限された値を検索語にしたときに件数やレコードの一致だけ返れば、その語を含むことが推測できます。本文表示と一致判定の両方を対策範囲にします。
修正範囲を生成元と共通処理に分ける
確認した生成元と共通処理を整理すると、次のようになります。すべてのファイルに変更が必要という意味ではなく、修正漏れを確認するための対応表です。
| 対象 | 生成元や定義 | 共通処理・生成結果 |
|---|---|---|
| 通常形式のAPI出力 |
Model_GetByApi_Body.txt、Model_GetByApi_ColumnCases.json
|
各モデルの GetByApi()
|
| 汎用形式のAPI出力 |
GridData_KeyValues_Body.txt、Model_ToApiValueColumnCases.json
|
GridData、各モデルの汎用変換 |
| 秘密項目の保護 | Definition_Column/Users_*.json |
列の読取り制御 |
| 添付情報の取込み | Model_SetByApi_Body.txt |
Attachment、Attachments
|
| 公開サイトの選択肢 | 今回は共通処理を中心に確認 |
DropDowns、SiteSettings
|
| レコード単位の項目権限 | API・出力テンプレート |
ReadableColumns()、ColumnAccessControl、権限キャッシュ |
| JSON出力 |
Model_Export_Body.txt、Model_ExportSet_Body.txt
|
各 ExportModel
|
| カスタムデザイン | Model_Utilities_TdValue_Body.txt |
各 Utilities
|
| 編集画面のmetaタグ | Model_Utilities_EditorItem_Body.txt |
HtmlTemplates |
| 検索索引 | Model_FullText_Body.txt |
各モデルの FullText()、FullTextExtensions
|
生成済みの ResultModel.cs だけを修正しても、テンプレートが同じコードを作るなら再生成で戻る可能性があります。逆に、テンプレートだけを変えても、配布物に使う生成済みコードが変わらなければ実行時の動作は変わりません。
生成元の変更、再生成後の差分確認、共通処理の変更、実行時の検証を一続きの作業として扱います。
修正後に確認したいケース
今回のような問題では、成功する操作だけでなく、拒否すべき組合せを出力経路ごとに確認します。
| 分類 | 確認するケース |
|---|---|
| 秘密項目 | 通常形式・汎用形式・表示形式を変えても秘密値を返さない |
| 添付ファイル | 正規の添付は保存でき、管理外のパスや他者の一時ファイルは読めない |
| 情報公開 | 正規の選択肢は表示でき、候補外IDの検索・選択・表示名補完では情報を返さない |
| レコード条件 | 同じユーザーで条件を満たすレコードと満たさないレコードを連続取得する |
| 静的な項目条件 | ユーザー・グループ・組織で許可と不許可を分ける |
| 出力先 | API、JSON、サーバスクリプト、合成列、カスタムデザイン、metaタグ、検索結果を確認する |
| 再生成 | 再生成しても対策が残り、別モデルにも必要な制御が反映される |
期待結果を決めてから回帰テストを作る
「制限が効くこと」だけでは、どこまで検証したかが曖昧になります。次のように入力条件と期待結果を固定します。以下は実施済みの結果ではなく、修正時の回帰テスト設計です。
| ケース | 条件 | 期待結果 |
|---|---|---|
| 秘密列の出力 | 通常形式と汎用形式の両方で秘密列を指定 | 値がJSONに含まれず、汎用形式へ変えても結果が変わらない |
| パスの境界 | 保存先と先頭文字が似ている別ディレクトリを指定 | 保存範囲外として拒否 |
| 他者のアップロード | 同じテナントの別ユーザーが発行済みIDを指定 | 正しいIDでも所有者不一致として拒否 |
| 正規候補の次ページ | 許可済みだが現在のページにはない候補を選択 | 共通の許可候補クエリで解決できる |
| 候補外ID | 実在するが公開対象でないIDを指定 | 名前を返さず、存在しないIDとも応答を揃える |
| 権限キャッシュ | 許可レコードAと不許可レコードBをA→B、B→Aで取得 | 取得順序に関係なくAだけが値を持つ |
| metaの代替値 | 本文は不許可で、サイト側の本文にも値がある | 禁止された値を代替として使わない |
| 検索による推測 | 制限項目だけに存在する語で検索 | 不許可ユーザーにその語の存在を示す一致情報を返さない |
空文字列を返したかだけで確認すると、ItemTitle、カスタムデザイン、検索の抜粋など、同じ値を別名で返す経路を見落とします。応答全体に検証用の値が残っていないことも確認します。
まとめ
- 秘密項目を1つのAPIモデルから外すだけでは、別の出力形式まで保護できません。
- 添付情報はファイルパスとして信用せず、サーバーが管理するアップロード情報から解決します。
- 公開サイトの選択肢は、検索や表示名補完も含めて同じ公開範囲に制限します。
- 項目権限は、対象ユーザー・対象レコード・参照元項目を揃えて最終出力時に判定します。
- 生成されたC#と生成元テンプレートを両方確認し、再生成後も対策が維持されることを検証します。
画面、API、エクスポート、検索は、同じ値の別の出口です。コード生成を使うシステムでは、出口ごとの処理を追うと同時に、その処理を繰り返し作る生成元まで読むことで、修正すべき範囲が見えてきます。