Java SDK 17.3.0
互換性に影響する変更
KeeperFile.url:StringからString?に変更。urlを必ず存在するものとして扱っていたコードでは、nullの可能性を考慮した処理が必要です。サーバー側でこのフィールドが省略される場合があり、以前の動作ではNPEクラッシュが発生していました。
KeeperRecordData.custom:MutableList<KeeperRecordField>?からnull不可のMutableList<KeeperRecordField>に変更。このフィールドにnullを代入するとコンパイルエラーとなるため、空のリストを使用してください。
KEY_SERVER_PUBIC_KEY_IDの非推奨化: 17.2.0で公開された誤記を含む定数名を正しいKEY_SERVER_PUBLIC_KEY_IDに置き換えました。旧名称はソースおよびバイトコード互換性維持のため@Deprecatedエイリアスとして引き続き利用できます。保存される構成キー ("serverPublicKeyId") に変更はありません。
KSM-878 / KSM-1032: 指数バックオフによる自動スロットリングリトライ機能を追加。HTTP 403によるスロットリング応答を最大5回まで自動的に再試行 (11～176秒、±25%のジッター付き）。応答に
retry_afterが含まれる場合はその値を優先。再試行回数を超えた場合はKeeperThrottleExceptionを送出。KSM-1008: 型付きの
KeeperRecordLinkアクセサを追加 (Python版と同等)。権限のブール値 (allowsRotation、allowsConnectionsなど、allowedSettingsをフォールバックとして利用)、認証情報フラグ、AI/JIT設定およびメタデータへのアクセサに対応。KSM-902: カスタムサーバー公開鍵のサポートを追加。構成項目
serverPublicKey、4セグメント形式のワンタイムトークン、またはSecretsManagerOptionsから指定可能。カスタム公開鍵が有効な間、サーバーからの鍵ローテーション通知は暗黙的に上書きせず、明確なエラーを送出。KSM-1026:
SecretsManagerExceptionを公開 (open class) クラスに変更。SDKの例外を型で捕捉できるようになりました。KeeperThrottleExceptionもこのクラスを継承する公開クラスとなりました。KSM-1072:
PamSettingsConnectionにdbConnectionMethodフィールドを追加。他SDKと同等のフィールド構成となりました。KSM-823: カスタムフィールド未設定時に、レコード作成ペイロードから
KeeperRecordData.customが欠落する不具合を修正。デフォルトで空のリストが設定されるようになりました。KSM-854: iOS、Android、またはウェブボルトで作成されたレコードからファイルメタデータをダウンロードする際にクラッシュする不具合を修正。これらのクライアントでは
lastModifiedを省略するため、従来はデシリアライザーで必須項目として扱われていました。KSM-753: 共有フォルダ内レコードのフィールドがnullを返していた不具合を修正。コマンダーまたはPowerShellで作成され、フォルダキーで暗号化されたレコードを誤ってアプリキーで復号していた不具合を解消しました。
KSM-765: ファイルの
urlフィールドが欠落している場合にNPEクラッシュが発生していた不具合を修正。downloadFile()は型付きの例外を送出。KSM-855:
LocalConfigStorageにおけるファイルディスクリプタリーク、およびdownloadFile、uploadFile、postFunctionにおける接続リークを修正。KSM-985:
base64ToBytes("")およびwebSafe64ToBytes("")の不具合を修正。空の入力時に不可解なNPEが発生していた不具合を解消し、両関数とも対象フィールド名を示すSecretsManagerExceptionを送出。KSM-1066 / KSM-1067: IL5環境で
serverPublicKeyが初期化後にLocalConfigStorageへ保存されない不具合を修正。また、サーバーからの鍵ローテーション通知によって設定済みのカスタム鍵が暗黙的に上書きされる不具合も修正。
リンク
最終更新