0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

プリザンター1.5.10.0の追加機能を詳しくみてみる

0
Posted at

はじめに

プリザンターの 1.5.10.0 がリリースされました(公式リリースの公開は 2026 年 11 月 17 日)。前回の「プリザンター1.5.9.0の追加機能を詳しくみてみる」では「運用まわりの使い勝手と守りを固める回」と書きましたが、今回はその続きで、運用基盤の足回りを整える回という印象です。

キューへの一括更新の追加、API キーの IP 制限の IPv6 対応、システムログのテナント ID、Quartz のエラー記録とテーブル定義の見直し、画像処理ライブラリの入れ替えなどが並びます。加えて、リリースノートの後半にはセキュリティ関連の修正が多く含まれています。この記事ではソースコードを追いかけながら、1.5.10.0 で何が変わったのかを整理してみます。

バージョン 1.5.10.0 を対象にしています。差分は 1.5.9.1 との比較です(2,035 ファイルの変更ですが、約 1,750 ファイルは画面表示の言語リソースと列定義への繁体字の追記です)。リリースノートに載っている項目を中心に、ソースを読んで分かったことを補足しています。ソースのリンクは 1.5.10.0 のコミット(c6d8974df84ab5ba6029aaf394f9613b3a4211cb)に固定しています。

追加機能の全体像

分類 追加・変更された主なもの ひとことで言うと
言語 繁体字(zh_tw)の追加 ユーザ・テナントの言語に「Traditional Chinese」が増えた
キューイング 一括更新のキュー化 大量レコードの一括更新をバックグラウンドで実行できる
システムログ TenantId 列の追加 どのテナントで起きたログかを記録・絞り込みできる
API キーの IP 制限 IPv6 対応 CIDR に IPv6 アドレスを書ける。判定を .NET 標準の IPNetwork に変更
Quartz エラーのシステムログ記録、テーブル定義の変更 スケジューラの内部エラーが見えるようになる
API・スクリプト サイト情報の返却範囲 AI 連携の API キーをマスクし、サイト設定はサイト管理者にだけ返す
画像処理 ImageSharp から SkiaSharp へ 画像の読み書きのライブラリを変更
サーバスクリプト httpClient の Cookie とリダイレクト 並行実行間の Cookie 混入を解消。リダイレクトを自前で追跡
パラメータ 4 つの新パラメータ Service.json などに設定が増えた(一部はリリースノート未記載)

この記事の「パラメータ」「列」に関する記述は、1.5.10.0 のソースで確認できたものです。ライセンスや提供条件の最終的な扱いは公式の案内を確認してください。

繁体字(zh_tw)の言語対応

ユーザ・テナント・登録の「言語」に繁体字が追加されました。ユーザの言語選択には「Traditional Chinese」が並びます。拡張項目の定義(ExtendedColumnDefinitions)や列定義にも LabelText_zh_tw が追記されており、ファイル数が膨らんだ主な原因はこの言語リソースです。

言語コードの対応は LanguageUtilities にあり、zh_tw は .NET のカルチャ名 zh-TW に対応づけられます(LanguageUtilities.cs)。

自動テストの期待値も更新されています。ユーザ編集画面の言語の選択肢は「English, Japanese, Chinese, German, Korean, Spanish, Vietnamese, Traditional Chinese」の順です。

キューイング機能に「一括更新」を追加

1.5.9.0 で一括削除が追加されたキューイング機能に、今回は一括更新が加わりました。一覧画面で複数のレコードを選んで項目を一括で書き換える操作を、バックグラウンドジョブとして実行できます。

キューに載る条件

判定は BackgroundJobQueue.ShouldQueueBulkUpdate() です。

BackgroundJobQueue.cs
public static bool ShouldQueueBulkUpdate(Context context, SiteSettings ss)
{
    if (ShouldQueue(
        jobType: BackgroundJobTypes.BulkUpdate,
        canQueueReferenceType: CanQueueBulkUpdateReferenceType(
            referenceType: ss?.ReferenceType)) == false)
    {
        return false;
    }
    var threshold = Parameters.BackgroundJobs?.BulkQueueThreshold ?? 0;
    if (threshold == 0)
    {
        return true;
    }
    if (context.CanUpdate(ss: ss) == false)
    {
        return false;
    }
    return BulkUpdateTargetCount(
        context: context,
        ss: ss) >= threshold;
}

読み取れる条件は次のとおりです。

  • 対象のサイトの種類は課題管理(Issues)と記録テーブル(Results)のみ。それ以外のサイトはキューに載りません
  • 共通の ShouldQueue で、バックグラウンドキューが有効であること、そのジョブ種別(BulkUpdate)が無効化されていないことも確認されます。エクスポートなど他のジョブと同じ判定です
  • BulkQueueThreshold が 0 なら、条件を満たす限り常にキューへ載ります
  • しきい値を設定している場合は、更新権限があることを確認したうえで、対象件数がしきい値以上のときだけキューへ載ります。しきい値未満の件数は、従来どおりその場で更新されます

対象件数の数え方

BulkUpdateTargetCount は、チェックを付けた行だけが対象なら選択数をそのまま返し、「すべて選択」の場合は現在のビューの条件で COUNT を発行します。画面に表示されていない行まで含めて、キューへ載せるかどうかを判断できます。

キューに載せる前の検証と、実行時の処理

キューへ載せる前に ValidateBeforeEnqueueBulkUpdate が走ります。更新権限、更新対象の項目、選択状態、ロックされたレコードの有無を、投入する時点で確認します。実行時に初めてエラーになるのを避けるためです。

実行は新設された BulkUpdateJobHandler が担当します(BulkUpdateJobHandler.cs)。

  • 投入時に画面の状態(フォームの値、セッション、言語、タイムゾーン、画面のパスなど)を BulkUpdateJobParameters として保存します
  • 実行時は、ジョブを投入したユーザの権限で Context を作り直し、同じ検証と更新を行います(IsBackgroundJob = true)
  • 1 件ずつ更新し、成功件数と失敗件数を数えて結果メッセージに残します。以前は更新した件数だけでしたが、失敗した件数も分かれます
  • 更新の入口は、画面から直接実行する場合と共通の BulkUpdateCore に切り出されました

画面から実行した場合の挙動も整理されています。BulkUpdate が BulkUpdateCore の結果を受け取り、権限なし・対象未選択・取り込み中ロックのエラーをメッセージに変換します。

システムログに TenantId を記録する

システムログ(SysLogs)に TenantId 列が追加されました。複数のテナントを運用する環境で、どのテナントで発生したログなのかを区別できます。

列の定義

列定義(SysLogs_TenantId.json)は次のとおりです。

項目 値
型 int
既定値 0
NULL 許可
一覧・フィルタ・エディタ すべて有効
更新時のアクセス制御 ManageService

ログの生成時に context.TenantId が設定されます。APIで取得するときも TenantId が含まれ、エクスポートにも出力されます。

見える範囲

ここが運用上いちばん大事です。Permissions.ApplySysLogsTenantFilter() は次の判定です(Permissions.cs)。

Permissions.cs
public static bool ApplySysLogsTenantFilter(Context context)
{
    return !(context.HasPrivilege
        && Parameters.MultiTenant.IsProtectedTenant(context.TenantId));
}

特権ユーザで、かつ保護されたテナント(MultiTenant の設定で指定されたテナント)にいる場合だけテナントによる絞り込みが外れ、全テナントのログを見られます。それ以外のユーザは、自分のテナントのログだけに絞り込まれます。

フィルタの選択肢は TenantIdFilterOptions が作ります。テナントの一覧を「[テナントID] 名前」の形式で選べますが、絞り込みが有効な(見える範囲が限られる)ユーザには選択肢を返しません。

リリースノートには、SysLog.json の NotLoggingIp に設定した IP アドレスからのアクセスがログに記録されてしまう問題と、IPv6 の接続元アドレスが正しく記録されない問題の修正も入っています。後者に対応して、SysLogs.UserHostAddress 列の長さが 16 文字から 50 文字に広げられました(IPv6 アドレスは 16 文字に収まらないため)。

API キーの IP 制限が IPv6 に対応

1.5.9.0 で追加された、API キーごとの許可 IP 範囲(Users.ApiAllowIpAddressRange)に IPv6 を書けるようになりました。1.5.9.0 では IPv4 のみでしたが、判定の中身が作り直されています。

書き方

改行区切りで複数指定するのは今までどおりです。

203.0.113.0/24
198.51.100.25
2001:db8:1234::/48
2001:db8::1

判定の中身

IpRange クラスは、独自の開始・終了アドレスの比較をやめ、.NET の IPNetwork を使うようになりました(IpRange.cs)。

  • 接頭辞の長さ(/n)は IPv4 が 1〜32、IPv6 が 1〜128。省略した場合は単一のアドレスとして扱います
  • IPv4 は 4 つの数字を . でつないだ形式のみ受け付けます。各数字の先頭の 0 は取り除いて解釈します(198.051.100.025 は 198.51.100.25)
  • % を含むスコープ付きの IPv6 アドレスは受け付けません
  • IPv4 射影アドレス(::ffff:203.0.113.5 のような形)でアクセスしてきた場合は、IPv4 の範囲に対しては IPv4 として比較します

保存時と判定時の厳しさの違い

ApiKeyIpRestrictions は、保存時の検証で strictPrefixLength: true を指定します。範囲外の接頭辞(/33 や /0 など)はエラーです。一方、IpRange.FromCidr で実際に判定する側は、範囲外の接頭辞を単一のアドレス(/32 または /128)として扱います。解釈できない値は無視し、システムログに警告を一度だけ出します。

つまり、画面から設定するときは厳密に検証され、すでに保存されている値は緩く読む、という二段構えです。無効な値はその行が「どこにも一致しない範囲」として扱われます。無効な行しかない場合の最終的な許可・拒否の挙動までは、この記事では追えていません。

Quartz まわりの変更

スケジューラのエラーをシステムログへ

QuartzSchedulerErrorListener が新設されました。Quartz が内部で起こしたスケジューラエラーを受け取り、アプリケーションログに出したうえで、システムログ(SysLogs)にも例外として記録します(QuartzSchedulerErrorListener.cs)。

記録される内容は次のとおりです。

  • コントローラー名は CustomQuartzHostedService、アクション名は発生したメソッド名
  • テナント ID は 0
  • スタックトレースは、SysLog.json の OutputErrorDetails が有効なら例外の全文、そうでなければスタックトレースのみ
  • システムログへの書き込み自体が失敗した場合は、アプリケーションログにその旨を出す

バックグラウンドのジョブが動かないとき、これまではアプリケーションのログを探すしかありませんでしたが、システムログの画面から確認できます。

クラスタ化で使うテーブルの定義変更

Quartz をクラスタ構成で使う場合のテーブルが、Quartz 公式のテーブル定義に合わせて変更されました。列定義に次が追加されています。

  • QRTZ_TRIGGERS / QRTZ_FIRED_TRIGGERS の EXECUTION_GROUP
  • QRTZ_TRIGGERS の MISFIRE_ORIG_FIRE_TIME、PREFERRED_NODE、PREFERRED_NODE_AUTO

インデックスは QuartzIndexes が、Quartz.Clustering.Enabled が有効なときだけ作ります。インデックス名は IDX_ に TablePrefix とテーブルごとの名前をつないだ形で、PostgreSQL では小文字にそろえます。

リリースノートには、クラスタ構成でリマインダーなどのバックグラウンドジョブが複数のサーバで同時に実行される問題と、MySQL でクラスタ化を有効にするとジョブが動かない問題の修正も入っています。Quartz のクラスタ化を使っている環境は、更新後に CodeDefiner を実行してテーブル定義を揃え、ジョブの実行状況を確認してください。

サイト情報の返却範囲を絞る

サイトの情報を取得する API、スクリプト、サーバスクリプトの返却内容が変わりました。

  1. AI 連携の API キーをマスクする。AiProviderUtilities.MaskConnectionSettings が、プロバイダーの接続設定のうち秘密の項目を伏せ字にします
  2. サイト設定(SiteSettings)はサイトの管理権限を持つユーザにだけ返す。権限がなければ null です

実装は SiteSettings の 2 つのメソッドです。

SiteSettings.cs
public SiteSettings RecordingDataForApi(Context context, bool canManageSite)
{
    if (!canManageSite)
    {
        return null;
    }
    var ss = RecordingData(context: context);
    AiProviderUtilities.MaskConnectionSettings(ss: ss);
    return ss;
}

public SiteSettings ForServerScript(bool canManageSite)
{
    if (!canManageSite)
    {
        return null;
    }
    var ss = SiteSettingsUtilities.CopySiteSettings(this);
    AiProviderUtilities.MaskConnectionSettings(ss: ss);
    return ss;
}

API で取得したサイト設定をそのまま更新用のリクエストに使い回すと、マスクされた値が戻ってくることになります。これに備えて、ResolveMaskedConnectionSettings が、伏せ字のまま送られた項目を保存済みの値で復元します。取得して加工し、更新するという運用の人は、サイトの管理権限があるユーザで実行しているかを確認してください。

画像処理ライブラリを SkiaSharp に変更

画像処理ライブラリが SixLabors.ImageSharp から SkiaSharp に変わりました。プロジェクトの参照は次のように変わっています。

- SixLabors.ImageSharp 3.1.12
+ SkiaSharp 4.153.1
+ SkiaSharp.NativeAssets.Linux.NoDependencies 4.153.1

ImageData が書き直され、読み込める形式は PNG・JPEG・GIF・BMP・WebP に限られます。それ以外は Unsupported image format で失敗します。EXIF の向きの情報は読み込み時に反映されます。ApngEncoder(アニメーション PNG の出力)も新設されました。

リリースノートには、外部ストレージを使っているときにサムネイルではなく原寸の画像が表示されることがある問題の修正が入っています。

画像のサムネイル作成は、ライブラリの違いで出力のバイト列が変わる可能性があります。更新後は、添付ファイルの画像とサムネイル、アニメーション GIF が期待どおり表示されるかを確認しておくと安心です。Linux の場合は、ネイティブライブラリが同梱される SkiaSharp.NativeAssets.Linux.NoDependencies を使う構成です。

サーバスクリプトの httpClient

サーバスクリプトの httpClient の中身が大きく変わりました。

Cookie が混ざる問題の修正

以前は、並行して実行された別の処理の Cookie が混ざる問題がありました。HttpClient は自動の Cookie 管理を無効(UseCookies = false)にし、リクエストごとの Context が持つ CookieContainer を使います。応答の Cookie は、そのコンテキストの中でだけ保持されます。

リダイレクトを自前で追跡する

自動のリダイレクト追跡(AllowAutoRedirect)も無効にして、Core メソッドの中でループして追跡します。判定の条件は次のとおりです。

  • 追跡するステータスは 300・301・302・303・307・308
  • 上限は Script.json の ServerScriptHttpClientMaxRedirectCount(既定 50)
  • Location がない場合、上限を超えた場合は追跡せず、その応答を返します
  • 移動先が http / https 以外のスキームのときと、https から http への移動は追跡しません
  • メソッドを GET に切り替える場合は、本文も付けません

リダイレクト先でのヘッダーの扱いは、元のアドレスとの関係を見て決めています(CreateHttpRequest に元のアドレスとリダイレクト済みかどうかを渡しています)。細かな扱いは今回は追いきれていないので、認証ヘッダーを付けて外部サービスを呼んでいる場合は、リダイレクトを伴う呼び出しを検証環境で試してください。

リリースノートに載っていないパラメータ

差分から、リリースノートに書かれていない新しいパラメータが 4 つ見つかりました。

ファイル パラメータ 既定値 内容
Service.json RestrictExtendedColumns false 拡張項目を契約の許可がある場合だけ使えるようにする
Validation.json ServerRegexValidationTimeout 1000 サーバ側の正規表現による入力検証のタイムアウト(ミリ秒)
Script.json ServerScriptHttpClientMaxRedirectCount 50 サーバスクリプトの httpClient のリダイレクト上限
McpServer.json LogPartialMatchDefaultStartTimeRangeDays 31 MCP ログの部分一致検索で、開始日時を指定しないときに遡る日数

拡張項目を契約で制限する RestrictExtendedColumns

true にすると、ContractSettings.ExtendedColumns() は、テナントの契約設定に ExtendedColumns の許可がある場合だけ true を返します(ContractSettings.cs)。許可のない項目は Column.NotAllowedByContract が立ち、一覧・編集・エクスポート・計算式の対象から外れます。拡張項目を参照する計算式も無効になります。

既定は false で、制限はかかりません。多くのテナントを預かるサービス提供者向けの設定で、通常の利用では意識する必要はなさそうです。

正規表現のタイムアウト

項目に設定した正規表現による入力検証が、サーバ側でタイムアウトを持つようになりました。ServerRegexValidationTimeout が 0 以下などの不正な値のときは、既定の 1000 ミリ秒が使われます(Validators.cs)。処理が終わらない正規表現を入れられても、サーバが占有され続けにくくなります。

MCP ログの部分一致

リリースノートの「MCP ログが大量にある環境で、レスポンスデータ・リクエストデータを部分一致で絞り込むと応答が返らない」の修正に対応するパラメータです。McpLogGridPolicy が新設され、レスポンスデータかリクエストデータを部分一致で絞り込み、かつ開始日時の条件がない場合に、開始日時の条件として**直近 31 日分(今日を含む)**が自動で加わります。0 以下や、取り得る範囲を超える値のときは 31 日になります。

セキュリティ関連の修正

リリースノートの後半には、次の修正が並んでいます。

  • 組織・グループ・ユーザを同じ秒のうちに続けて作成・更新すると、アクセス権や名前が正しく表示されない
  • ユーザ取得 API で、認証に関わる項目を取得できる
  • 添付ファイルの登録・更新時に、入力値の検証が不足している
  • サイト公開機能で、公開の対象ではない情報を参照できる
  • 項目のアクセス制御で読取りを制限した項目の値を、許可されていないユーザが参照できる
  • サーバスクリプトでユーザ・組織・グループを取得したとき、テナント管理者のみが取得できる項目を一般ユーザが取得できる
  • 無効にしたユーザでもパスキー認証でログインできる
  • パスキーの登録の途中で別のユーザでログインし直しても、登録が完了できてしまう
  • MCP ログ画面で、別テナントのログ明細を ID を指定して表示できる

すべてを追いかけたわけではありませんが、差分から読み取れたものを 2 つ挙げます。

添付ファイルの一時ファイルのパス。Attachment に TryGetTempFilePath が追加され、一時ファイルの場所を決めるときに次の検証を行います。

Attachment.cs
internal static bool TryGetTempFilePath(string guid, string name, out string path)
{
    path = null;
    if (!Validators.IsValidGuid(guid))
    {
        return false;
    }
    if (name.IsNullOrEmpty()
        || !Files.ValidateFileName(name)
        || Path.GetFileName(name) != name)
    {
        return false;
    }
    var tempRoot = Path.GetFullPath(Path.Combine(Directories.Temp(), guid))
        + Path.DirectorySeparatorChar;
    var fullPath = Path.GetFullPath(Path.Combine(tempRoot, name));
    if (!fullPath.StartsWith(tempRoot, StringComparison.Ordinal))
    {
        return false;
    }
    path = fullPath;
    return true;
}

GUID の形式、ファイル名にディレクトリの区切りが含まれないこと、組み立てた結果が一時フォルダの中に収まっていることを確認します。ファイル名にパスをもぐり込ませるパストラバーサルを、入口でまとめて防ぐ作りです。検証に失敗した場合の読み出しは AttachmentPathTraversalException になります。

サイト公開機能の範囲。Permissions.PublishScope()(公開用のコントローラー経由のリクエスト)が追加され、公開のときは公開対象のサイトの ID に絞った条件が組み立てられます。公開用の URL から、対象外のサイトのレコードを引けないようにする変更です。

セキュリティ修正を含むため、1.5.9.1 以前を使っている環境は、更新を検討してください。とくに、サイト公開機能、パスキー認証、API でユーザ情報を取得する運用、項目のアクセス制御を使っている環境は影響を受ける可能性があります。

その他の変更

  • API の ImageHash: 指定した画像の検証に失敗した場合は、エラーを返し、レコードを作成・更新しないよう変更されました(リリースノートの記載。この記事では実装の詳細は追えていません)
  • 一括処理でのAI連携(RAG)の同期: インポート・一括更新・サマリの同期などで、レコードごとに同期が実行されていた問題が修正されました。差分では AiConnectSyncSuppression という仕組みが一括更新の中に入っています
  • MCP ログ画面: 開始日時・終了日時のずれ、ユーザのフィルタ、列見出しのソートメニュー、prompts/get の対象名など、複数の修正が入っています
  • CodeDefiner: /c オプション実行時のフルテキストインデックスの作成エラー、PostgreSQL でテナントなどのテーブルが毎回再作成される問題が修正されました
  • ライセンス案内 URL: General.json の HtmlTrialLicenseUrl が、新しいトライアルの案内ページを指すようになりました

更新時の確認ポイント

機能 確認する条件と動作
一括更新のキュー キューのライセンスと設定を確認する。検証用データで BulkQueueThreshold の前後の件数を試し、成功・失敗の件数がメッセージに出ることを確認する
API キーの IP 制限 IPv6 の許可範囲を設定し、範囲の内外から呼び出す。接頭辞が範囲外の値が保存時にエラーになることを確認する
システムログ 更新後に CodeDefiner を実行し、TenantId 列が追加されることを確認する。特権ユーザと一般ユーザで見える範囲を比べる
Quartz クラスタ化を使っている場合は、テーブル定義の変更後にジョブが重複せず動くことを確認する
サイト情報の API サイトの管理権限がないユーザで null が返ることと、マスクされた接続設定を送り返したときの動作を確認する
画像 添付ファイルの画像、サムネイル、アニメーション GIF の表示を確認する
httpClient リダイレクトを伴う外部呼び出しと、Cookie を使うサービスの呼び出しを確認する

この表はソースから整理した確認項目です。今回の記事で、実機での動作検証までは行っていません。

まとめ

1.5.9.1 から 1.5.10.0 で変わった点を見てきました。

  • 繁体字: ユーザ・テナントの言語に追加
  • 一括更新のキュー: Issues と Results が対象。BulkQueueThreshold の件数以上でキューへ。成功・失敗の件数を記録
  • システムログの TenantId: ログの発生元テナントを記録。見える範囲は特権ユーザ(保護されたテナント)以外は自テナントに限定
  • API キーの IP 制限: IPv6 に対応。保存時は厳密に、判定時は緩く解釈
  • Quartz: スケジューラのエラーをシステムログへ。クラスタ化のテーブル定義を公式に合わせた
  • サイト情報: AI 連携の API キーをマスクし、サイト設定は管理者にだけ返す
  • 画像処理: SkiaSharp に変更。PNG・JPEG・GIF・BMP・WebP に対応
  • httpClient: Cookie の混入を解消。リダイレクトを自前で追跡し、上限は ServerScriptHttpClientMaxRedirectCount(既定 50)
  • 新パラメータ: RestrictExtendedColumns、ServerRegexValidationTimeout、LogPartialMatchDefaultStartTimeRangeDays など

1.5.9.0 が「運用の機能を増やす回」だったのに対し、1.5.10.0 は足回りの整備と、守りの穴をふさぐ回です。機能追加は地味ですが、リリースノートの後半に並ぶセキュリティ修正の数は、見過ごせません。

バージョンアップの前に、次の 3 点を確認しておいてください。

  • CodeDefiner の実行: システムログの TenantId 列と、Quartz のテーブル定義が変わります
  • 画像まわり: ライブラリが変わるので、サムネイルと GIF の表示を確認する
  • API で取得したサイト設定を更新に使っている運用: サイトの管理権限がないと null が返り、AI 連携の API キーはマスクされる

修正版の適用は、とくにサイト公開機能やパスキー認証を使っている環境では、早めに検討するのがよさそうです。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?