• サポート
  • ヘルプデスク FAQ
  • API キーによるライセンス設定

Help Desk

From Houdini 20.5
API キーによるライセンス設定 - #596

API キーによる認証設定は、ユーザによる手動操作が望ましくない環境に最適です。

API キーによるライセンシングを設定すると、hkey による手動のログインをせずとも、 ログインベースのライセンシング ができるようになります。ファームマシンなど、特定の環境で役立ちます。

ログインベースのライセンシングを行うと、お使いのマシンに直接ライセンスをインストールせずとも、SideFX ライセンスサーバから直接ライセンスにアクセスできるようになります。ただし、ログインベースのライセンシングによってライセンスにアクセスする際は、ネットへの接続を保つ必要があります。また、SideFX サーバ使用時にログインしないですむよう、ユーザにキーを配布することも可能です。レンダーノードにこのキーを配布することもできます。

API キーの生成

  1. お使いのライセンスのログイン情報を使って、SideFX ポータルにログインします。

  2. Services を選択し、Developers API セクション 以下の Manage applications authentication に移動します。

  3. Register a new application を選択し、"My API Keys" など好きなアプリケーション名を Name に入力します。

  4. これにより、クライアントIDとシークレットキーが自動的に生成されます。

  5. 下記のような設定が行われているかご確認ください。

API Key Setup

License Administrator を使った API キーの設定

License Administrator を起動し、File>Login を選択して、Use API Keys ボタンをクリックします。
クライアント ID とクライアントシークレットをコピー＆ペーストします。

hserver に API キーを設定する

License Administrator の File>Login >Use API Keys から API キーをコピー＆ペーストする代わりに、hserver.ini ファイルにキーを追加することもできます。

hserver.ini ファイルの場所は、hserver サーバをサービスとして実行しているかどうかによって異なります。
正確な場所は、ドキュメント を参照してください。

Windows

以下、hserver をシステムのサービスとして実行している例です（デフォルトの状態）。

%SystemDrive%\ProgramData\SideFX\ に、hserver.ini オプションファイルを配置してください。

例: C:\ProgramData\SideFX

APIKey=clientID clientSecret

services.msc の HoudiniServer サービスを再起動します。

hserver がサービスとして実行されていない場合は、%USERPROFILE%\AppData\Roaming\SideFX\ にhserver.ini ファイルを設置してください。

Linux

hserver を systemd サービスとして実行している場合は、/usr/lib/sesi/hserver へ hserver.ini ファイルを移動させる必要があります。hserver ディレクトリが存在しなければ、root ユーザとして作成するか、sudo を使って作成してください。

hserverをサービスとしてではなく、必要に応じて起動する方式で実行している場合:

$HOME/.local/share/sidefx/ に hserver.ini を作成します。

APIKey=clientID clientSecret

OSX

/Library/Preferences/sesi/hserver/ に hserver.ini オプションファイルを配置します。

hserver がサービスとして実行されていない場合は、$HOME/Library/Application Support/sidefx/ に hserver.ini ファイルを設置してください。

APIKey=clientID clientSecret

注意: ヘッドレスマシンで sesictrl を使用する場合

SideFX アカウントへのログインに sesictrl を使用している場合、ログイン情報は、コマンドに直接渡す必要があります。

sesictrl login --client-id [clientID] --client-secret [clientSecret]

hserver.ini ファイルや sesinetd.ini ファイルの設定は、sesictrl を使ったログインやライセンスの有効化には適用されません。
sesictrl のコマンドラインに、メールアドレス / パスワードのログイン情報または API キーを直接指定する必要があります。

HOUDINI_API_KEY_FILE 環境変数は使用できません。ログイン情報は、sesictrl のコマンドラインに直接指定する必要があります。

sesinetd.ini ファイル内の ClientID と ClientSecret は、sesinetd およびピーク使用状況ログのアップロード用スクリプトでのみ使用されます。