APIリファレンス

OZeroSecurityManager OZeroSDK.Security

すべてのアクティブなセキュリティモジュールを管理する中央シングルトンです。DontDestroyOnLoadによりシーン遷移時も維持されます。静的なInstanceプロパティからアクセスしてください。OZeroBootstrapperがランタイム起動時に[RuntimeInitializeOnLoadMethod]経由で自動生成します — 手動でインスタンス化しないでください。

プロパティ

メソッド

ユーザーチェーンにサードパーティコールバックを登録します。内蔵デフォルトハンドラは別チェーンで動作するため、ユーザーコールバックを解除しても無効化できません。コールバックは、モジュール種別、公開 abort code、メッセージキー、安全な診断メッセージ、現在のポリシーでアプリを終了するかを含む OZeroSecurityEvent を受け取ります。

以前に登録したユーザーコールバックを削除します。メモリリーク防止のため、OnDisableまたはOnDestroyで必ず呼び出してください。

デリゲート

RegisterUserCallback で使うコールバックシグネチャです。独自 UI、ログ、保存フローの判断には evt.Type、evt.AbortCodeHex、evt.MessageKey、evt.Message、evt.WillAbort を参照してください。

サンプルコード

using OZeroSDK.Security;
using UnityEngine;

public class MySecurityListener : MonoBehaviour
{
    void OnEnable()
        => OZeroSecurityManager.Instance.RegisterUserCallback(OnThreat);

    void OnDisable()
        => OZeroSecurityManager.Instance.UnregisterUserCallback(OnThreat);

    void OnThreat(OZeroSecurityEvent evt)
        => Debug.Log(
            $"Threat={evt.Type}, Code={evt.AbortCodeHex}, Message={evt.Message}");
}

OZeroSecurityEvent class

RegisterUserCallback に渡される顧客向けの違反イベント payload です。内部検出の詳細ではなく、安定した安全な診断情報だけを公開します。

ModulationType enum

どのセキュリティモジュールが警告を発生させたかを示します。OZeroSecurityEvent.Type として取得できます。

OZeroBootstrapper OZeroSDK.Security

ゼロ配線の自動ブートストラップエントリポイントです。このクラスを直接呼び出す必要はありません。SDKをUnityの起動フローへ接続し、検証済みのセキュリティ設定を読み込み、ゲーム開始前に有効なディテクターを自動で準備します。利用可能な場合、Nativeランタイム保護もここで初期化されます。

OZeroSecurityConfigRuntime OZeroSDK.Security

保護されたビルド時セキュリティ設定のランタイムローダーです。パッケージされた設定を検証し、インメモリのOZeroSecurityConfigスナップショットを準備し、検証失敗時は設定された脅威対応ポリシーを適用します。

プロパティ

メソッド

冪等なローダー — 繰り返し呼び出しても安全です。初回アクセスでパッケージ設定を検証・読み込み、以降は同じスナップショットを再利用します。失敗時の処理はグローバル脅威対応ポリシーに従います。

OZero Secure Variables OZeroSDK.Security

プリミティブ型の暗号化されたドロップイン代替品です。値はNative C++ヒープにのみ保存されOZero proprietary cipherで暗号化されます。フレームごとに48バイトのXORマスクが追加適用されるため、メモリスキャナーにはノイズしか見えません。すべての算術演算子と暗黙的な型変換がサポートされています — 型名の変更だけが必要です。

対応型一覧

対応演算子

数値型(Int、Int64、UInt、UInt64、Short、UShort、Byte、Float、Double、Decimal)はすべての算術(+ - * / %)、比較(== != < > <= >=)、複合代入(+= -= *= /=)、インクリメント/デクリメント(++ --)演算子と、対応するプリミティブ型との暗黙的変換をサポートします。Vector2・Vector3は算術および等価演算子をサポートします。Boolは等価演算子のみサポートします。Stringは==、!=、+をサポートします。Bufferはインデックス演算子による生のバイト配列アクセスを提供します。

OZeroSafePlayerPrefs OZeroSDK.Security

UnityのPlayerPrefsの暗号化されたドロップイン代替品です。キー名はmessage authenticationでハッシュされ、値はkey-derivation functionデバイスバインドキー（10万回反復）を使用したOZero proprietary cipherで暗号化されます。デバイスのレジストリ（Windows）や設定plist（iOS）を参照しても保存データは読めません。

メソッド

すべてのメソッドはPlayerPrefsと機能的に同一です。マイグレーション手順は不要 — クラス名を置き換えるだけです。

OZeroSV_File OZeroSDK.Security

組み込みの整合性検証とともにファイルを暗号化/復号します。キーはアプリレベル（デバイス非バインド）のためSteamクラウドセーブと互換性があります。読み込み時に整合性検証が走り、改ざんされたファイルは破損データを黙って返すのではなく例外を発生させます。

メソッド

contentsを暗号化し、保護されたペイロード(ヘッダ + 暗号文 + 認証タグ)をpathに書き込みます。ディレクトリは事前に存在している必要があります。

pathのファイルを読み込み、整合性を検証してから復号された文字列を返します。ファイルが改ざんされている場合InvalidDataExceptionをスローします。

生のバイト配列を暗号化してpathに書き込みます。

WriteAllBytesで書き込まれたファイルを読み込み復号します。返す前に整合性タグを検証します。

サンプルコード

using OZeroSDK.Security;

string path = Application.persistentDataPath + "/save.json";
string json = JsonUtility.ToJson(saveData);

// Write (encrypts automatically)
OZeroSV_File.WriteAllText(path, json);

// Read (decrypts + integrity check)
try
{
    string loaded = OZeroSV_File.ReadAllText(path);
    saveData = JsonUtility.FromJson<SaveData>(loaded);
}
catch (System.IO.InvalidDataException)
{
    // File was tampered — handle accordingly
    Debug.LogError("Save file integrity check failed.");
}

OZeroBuildIntegrityValidator OZeroSDK.Security

ビルド改ざん、デバッガー/タイミング異常、プラットフォームネイティブ整合性チェック、任意の Pro サーバー attestation、OZero Managed Verification を行うランタイム検証コンポーネントです。Build Integrity が OZeroSecurityConfig で有効な場合、OZeroBootstrapper が自動生成します。

検査内容

公開プロパティ

イベントとメソッド

有効なすべてのローカル検査が通過したときに呼び出されます。

有効なローカル検査または Pro attestation がビルドを拒否したときに呼び出されます。

Pro サーバー attestation が成功し、AttestationToken に有効なトークンが入った後に呼び出されます。

手動検証を開始します。通常はダッシュボードの起動時/定期検証設定を使用します。

OZeroSpeedHackDetector OZeroSDK.Security

5つの独立した検知シグナルを使用してスピードハックと時間操作を検知します。シグナルが互いに確認し合った場合のみ脅威を報告し、誤検知を減らします。

検知シグナル

検知はModulationType.SpeedHackまたはModulationType.TimeHackでOZeroSecurityManagerコールバックを通じて発生します。OZeroSecurityConfigで設定します。

OZeroInjectionDetector OZeroSDK.Security

異常なランタイムモジュール、フック、デバッガー、信頼モジュールポリシーのシグナルを観察します。周期チェックは可能な場合Jitterスケジューリングを使用し、予測しやすいスキャンタイミングを減らします。

検知対象

検知はModulationType.InjectionでOZeroSecurityManagerコールバックを通じて発生します。

OZeroSecurityConfig ScriptableObject

グローバルセキュリティ設定を保存するScriptableObjectアセットです。エディターで作成すると、ビルドパイプラインがプレイヤービルド向けの保護されたランタイム設定としてパッケージします。実際に適用される設定はOZeroSecurityConfig.Instanceから参照します。

フィールド

フィールドはネストされた設定クラス(Response、Integrity、InstallSource、DeviceBinding、SpeedHack、Injection)にグループ化されており、OZeroSecurityConfig.Instanceの同名プロパティでアクセスします。よく調整されるフィールドを以下に列挙しています — 全項目はアセットのインスペクターツールチップを参照してください。

OZeroLicenseConfig OZeroSDK.Security.License

Resources/OZeroLicenseConfig から読み込まれる ScriptableObject です。ライセンスティア、Plus/Pro キー、任意の Pro ランタイム機能を設定します。未作成または空の場合は Standard/serverless として動作します。

フィールド

プロパティ

Resources からランタイム設定を読み込みます。null は Standard/serverless として扱います。

Standard、Plus、または空のライセンスキーの場合 true です。Pro アクティベーションが必要な場合のみ false です。

Plus と Pro の場合 true です。ビルド事前検証と native Variant バインディングで使われます。

OZeroLicenseRuntime OZeroSDK.Security.License

現在のライセンス状態を扱うランタイム facade です。アプリ起動時に自動初期化されるため、多くのプロジェクトでは状態参照または HasCapability の呼び出しだけで十分です。

プロパティ

メソッド

冪等な起動メソッドです。通常は SDK が自動呼び出ししますが、カスタム bootstrap ではライセンス状態を読む前に await できます。

有効な entitlement に telemetry、signed_time、attestation_v1 などの capability が含まれるか返します。Standard/serverless では false です。

ライセンスサーバーのランタイム呼び出し

Pro 機能は /v1 配下の HTTPS JSON 呼び出しを使います。ほとんどの呼び出しは SDK が自動で発行します。ゲームサーバーを持つチームは /v1/validate で OZA トークンを直接検証し、高価値アクションでは consumeToken=true で tokenId の再利用を防げます。持たないチームは Managed Verification で OZero の verdict を利用できます。

OZeroAbortCode とイベントメッセージ

確定したセキュリティ違反が発生すると、SDK は OZeroSecurityEvent を生成します。イベントには ModulationType、安定した公開 OZeroAbortCode、MessageKey、安全な英語 Message、WillAbort が含まれます。

Abort code とメッセージ表

ログや多言語 UI では、OZeroAbortCode と MessageKey を基準値として使ってください。Message は開発者が状況を理解しやすい安全な表現にしているため、開発者向け画面や QA ログにそのまま表示できます。

ランタイムでのセキュリティイベント処理

SDK が abort する前に analytics キューをフラッシュする、開発者向け警告を表示する、graceful save を保存する必要がある場合は OZeroSecurityManager.RegisterUserCallback でハンドラを登録してください。現在の応答ポリシーでアプリを終了するかは evt.WillAbort で確認できます。

using OZeroSDK.Security;

void OnEnable()
{
    OZeroSecurityManager.Instance.RegisterUserCallback(OnHack);
}

void OnHack(OZeroSecurityEvent evt)
{
    Debug.LogWarning(
        $"OZero: {evt.Type} {evt.AbortCodeHex} {evt.MessageKey} - {evt.Message}");

    if (evt.WillAbort)
    {
        // Last chance to flush your own analytics or save state.
    }

    Analytics.FlushSync();
}

Injection Detector API OZeroSDK.Security

hash + signer-fingerprint ホワイトリストのプログラミング表面です。ランタイムでは OZeroDispatch を使い、ゲームに同梱する信頼項目は OZeroLicenseConfig に設定します。

DTO — OZeroInjectionWhitelistEntry

[Serializable]
public class OZeroInjectionWhitelistEntry
{
    // SHA-256 of the matched module file. Lowercase 64-char hex. Required.
    public string HashHex { get; set; }

    // SHA-256 of the module's signing certificate. Lowercase 64-char hex.
    // Empty ("") means "match by hash only" (only mode for Android .so / Linux ELF).
    public string SignerHex { get; set; }

    // Module file format hint — "pe" | "macho" | "so". Defaults to "so".
    public string Type { get; set; }

    // Optional human-readable note (UI / audit only — never sent to native).
    public string Comment { get; set; }
}

Unityからローカル信頼モジュール項目をシードする必要がある場合に使うDTOです。Pro顧客は通常、同じポリシーをポータルで管理します。

ランタイム API — OZeroDispatch

// Returns true when trusted-module policy support is available.
public static bool HasInjectionV3 { get; }

// Replace trusted module entries atomically. Pass null/empty to clear.
// Returns false when the runtime support is unavailable.
public static bool RegisterInjectionWhitelistHash(OZeroInjectionWhitelistEntry[] entries);

// Trusted-module aware scan. Returns true when a relevant runtime signal is observed.
// Output fields are diagnostic context for your review and may be empty.
public static bool DetectAssemblyInjectionV3(
    out bool   silencedByWhitelist,
    out string hashHex,
    out string signerHex,
    out string matchedModulePath);

3つのメソッドはいずれも static helper です。任意機能の連携面として扱い、まず利用可否を確認し、ローカルの信頼項目は最小限にしてください。

Config — OZeroLicenseConfig

// Inspector array of OZeroInjectionWhitelistEntry — preferred surface.
public OZeroInjectionWhitelistEntry[] InjectionWhitelistEntries { get; }

public string[] InjectionWhitelistKeywords { get; }

InjectionWhitelistEntries は信頼モジュールポリシーのローカルシードです。自分で同梱する、または明示的に信頼するモジュールにのみ使用してください。