API キー

組織の API キーを作成、確認、無効化します。

APIキーがあれば、別のシステムがあなたのワークフローを パートナー API — 実行を行うために誰かがMorphicを開く必要はありません。 API キー タブは管理者にのみ表示されます。

こちらへ直接アクセス: studio.morphic.com/settings/api-keys

キーは組織に属します

作成者個人のものではありません。その人が退職しても引き続き動作し、すべての管理者に一覧表示され、取り消すことができ、開始した各実行の料金は組織に請求されます。

キーを作成する

タブを開きます

組織のドロップダウン(左上のMorphicロゴ)を開き、Settingsを選択してから、 API キー 左サイドバー内の

[New key]をクリックします

1か月後に見て分かる名前を付けてください。― たとえば「key 2」ではなく、配置先のシステム名です。

スコープを選択します

3つが用意されており、パートナー連携では通常3つすべてが必要なため、フォームは初期状態で3つすべてが選択されています。キーに実行させたくないものの選択を解除してください。

  • workflows:read — ワークフローと、その受け取る入力を読み取る
  • runs:write — 実行を開始し、Webhookエンドポイントを登録する
  • runs:read — 実行のステータスと完了したアセットを読み取り、Webhookエンドポイントを一覧表示する

特定のワークフローに制限する

任意ですが、やっておく価値があります。チェックを入れて このキーを特定のワークフローに制限する をオンにして対象を選択します。それ以外の実行は拒否されるため、キーが漏えいした場合の被害を抑えられます。未選択のままなら、キーは組織で実行できるすべてのワークフローを実行できます。

クレジット上限を設定する

合計は必須です — キーには、それ以上使えない上限が必要です。1日ごと、1か月ごとの上限は任意で、どちらかを空欄にするとその期間の上限は設定されません。

合計額は、連携が次に誰かの確認を受けるまでに使える額を基準に選んでください。実際に使う額ではありません。これは予算ではなく、ブレーカーです。期間上限は合計額を超えられません。先に合計額の上限が適用されるためです。

そのキーで開始した実行のクレジットは組織に請求され、そのキーの上限に対してカウントされます。キーが開始した実行は、後から誰かがチャットに入り引き継いでも、そのキーに対してカウントされ続けます。そうしないと、1つの質問に答えた同僚が、残りの実行を組織の共通プールに移してしまうからです。その人自身のクレジット上限がある場合は、それも引き続き適用されます。

1日はUTC日、1か月はUTC暦月です。キーをいずれかの上限を超えさせる請求は拒否され、メッセージにはキー名と、到達した上限が表示されます。

有効期限を選択する

なし、30日、90日、または1年です。期限切れのキーは自動的に認証されなくなり、これが最も手軽なローテーションです。

シークレットをコピー

シークレットは表示されます 一度だけ。Morphicはそのハッシュのみを保持するため、再表示はできません。ダイアログを閉じる前にシークレットマネージャーへコピーしてください。

キーを持っている人なら誰でも、組織のクレジットを消費する実行を開始できます。コードにコミットしないでください。ブラウザに入れないでください。メールやチャットで送らないでください。漏えいしたら取り消してください。それがこのタブの用途です。

一覧に表示される内容

各キーには、名前、本番キーかテストキーか、シークレットの先頭文字列(自分の記録と照合するのに十分な情報)、スコープ、実行できるワークフロー数、クレジット上限、最後に使用された日時が表示されます。期限切れや取り消し済みのキーも一覧に残るため、何が起きたか確認できます。

組織が保持できるのは最大で 認証に使えるキーを 10 個 同時にです。期限切れおよび取り消し済みのキーは、その上限には含まれません。

キーのクレジット上限を変更する

  1. 一覧からキーを見つけます。
  2. 横の「…」メニューをクリックして、 上限を編集.
  3. 合計、または1日ごと・1か月ごとの上限を変更します。上限を解除するにはその項目を空にして、保存してください。

新しい上限は、キーの次の請求から適用され、すでに開始済みの実行にも反映されます。そのため、実行がキーの上限で止まった場合の対処法になります。取り消し済みのキーにも有効です。取り消し済みでもそのキーで開始された実行は引き続きそのキーに対して消費されるため、実行を止めるには上限を下げます。

キーを取り消す

  1. 一覧からキーを見つけます。
  2. 横の「…」メニューをクリックして、 キーを取り消す.
  3. 確認してください。

それを使う呼び出しは数秒以内に失敗し始めます。すでに進行中の実行は完了し、料金も請求されます。取り消しは元に戻せません。ローテーションする場合は、先に新しいキーを作成し、トラフィックを移してから古いキーを取り消してください。

支出の表示先

API経由で開始された実行のクレジットは組織に請求され、開始したキーに帰属します。表示場所は 請求と使用状況 → クレジットアクティビティ.

このページの内容