アプリケーションを管理¶

レジストリのアプリケーションページには、すべてのアプリケーションタブで使用可能なすべてのアプリケーションが一覧表示されます。次の表は、このページの要素と使用可能なアクションを示します。

	要素	説明
1	アプリケーション名	アプリケーション名。
2	バージョン	アプリケーションまたはソースのバージョン番号を一覧表示します。
3	開く	クリックすると、アプリケーションまたはソースが開きます。
4	アクションメニュー	アクションメニューから、以下の操作が可能です。共有：アプリケーションをユーザー、グループ、組織と共有できるほか、DataRobot以外のユーザーとも共有リンクを通じて共有できます。名前の変更：アプリケーションの名前を編集できます。ソースに移動：アプリケーションに関連付けられたソースを開きます。ソースの置換：アプリケーションに別のソースを選択できます。サービスの正常性：メモリー、CPU、およびネットワークの使用状況を表示するダッシュボードを開きます。ユースケースへのリンク：アプリケーションからユースケースへのリンクを確立し、ユースケースアセットにアプリケーションを表示します。ログを表示：アプリケーションのコンパイル、構築、および実行の履歴を表示します。アクセスログを表示：どのユーザーがいつアプリケーションにアクセスしたかを表示します。停止：アプリケーションを停止します。削除：アプリケーションを削除します。
5	検索	リスト内の特定のアプリケーションを検索するために使用します。
6	「アプリケーション」タブ	構築されたアプリケーションまたはアプリケーションソースの表示を選択します。
7	ドロップダウンを追加	追加ドロップダウンを使用して、アプリケーションをアップロードするか、または新しいアプリケーションソースを作成します。

共有機能は権限を管理し、ユーザー、グループ、組織、およびDataRobot以外の受信者とアプリケーションを共有できます。この機能は、アプリケーションを作成するための専門知識のないユーザーに既存のアプリケーションの使用を許可する場合などに便利です。

注意

複数のユーザーが同じアプリケーションにアクセスできる場合、各ユーザーは、別のユーザーが行った変更や予測を表示、編集、上書きしたり、アップロードしたデータセットを見たりすることができます。この動作は、アプリケーションの性質によって異なります。

すべてのアプリケーションタブで共有機能にアクセスするには、共有したいアプリの横にあるアクションメニュー をクリックし、共有を選択します。

これにより共有ウィンドウが開き、ユーザーとその役割がリストされます。エディターは、1つ以上のユーザーまたはグループ、組織全体でアプリケーションを共有できます。さらに、共有リンクを使ってアプリケーションを外部と共有できます。

ユーザー、グループ、組織外部共有

次と共有フィールドにユーザー名、グループ、または組織を入力します。
権限の設定には、ドロップダウンからロールを選択します。
通知を送信を選択してEメール通知を送信し、メモを追加を選択して通知に詳細を追加します。
共有をクリックします。グループまたは組織と共有している場合、アプリの共有先およびロールの適用先は、指定されたグループまたは組織のすべてのメンバーです。

外部共有では、リンク経由でDataRobotにアクセスできないエンドユーザーとアプリケーションを共有できます。 DataRobot以外のユーザーとアプリケーションを共有するには：

外部共有リンクタブをクリックします。タブ名の横にあるアイコンは、外部共有が現在有効かどうかを示します。
外部共有を有効にするをオンに切り替えます。追加のフィールドが以下に表示されます。
アプリケーションにアクセスできるようにしたいすべてのメールドメインとアドレスを追加します。メールアドレスとドメインは正しい形式（例：@datarobot.com）で入力する必要があります。また、ここにリストされているユーザーのみが共有リンク経由でアプリにアクセスできます。
アプリケーションリンクをコピーをクリックし、このリンクを前の手順で指定したすべてのユーザーに送信します。該当のユーザーにはDataRobotから招待メールが届きます。確認にはこのリンクが必要になります。招待メールは、ユーザーに送信されてから1時間後に有効期限が切れます。ユーザーが認証を受け入れると、作成された認証トークンは30日後に失効します。

アプリケーションのアクセス権を取り消す

外部共有を有効にするをオフに切り替えることで、いつでも共有リンクへのすべてのアクセス権を取り消すことができます。また、許可されたフィールドからメールドメインとアドレスを削除することで、個々のアクセス権を取り消すこともできます。

セルフマネージド環境での外部共有

セルフマネージド環境でアプリケーションを外部ユーザーと共有するには、簡易メール転送プロトコル（SMTP）サーバーを設定する必要があります。

DRApps CLIを使用して、アプリケーションをプログラムで共有することもできます。

共有ダイアログでは、次のアクションも使用できます。

ユーザーを削除するには、削除するユーザーの役割の右側にある「X」ボタンをクリックします。
ユーザーの役割を再度割り当てるには、割り当てられた役割をクリックして、ドロップダウンから新しい役割を割り当てます。

アプリケーションのAPIキー¶

アプリケーションの共有に加えて、アプリケーション内からデータにアクセスして使用する機能をユーザーに付与することもできます。アプリケーションのAPIキーは、DataRobotのパブリックAPIに対して必要なアクセス権をアプリケーションに付与します。共有ロールは、DataRobot内のエンティティとしてアプリケーションの制御を許可し、アプリケーションのAPIキーは、ユーザーがアクセスしたときにアプリが実行できるリクエストの制御を許可します。

ユーザーがアプリケーションにアクセスすると、アプリケーションのWebサーバーは、ユーザーのブラウザーからリクエストを受信します。アプリケーションのAPIキーは、アプリケーションが使用できるように、アプリケーションに対して行われるリクエストのヘッダーに含まれます。

アプリケーションキーは、アプリケーションを構築する際に自動的に作成されます。アプリケーションのAPIキーを設定するには、以下の手順に従います。

キーが付与するアクセスのスコープを編集するには、アプリケーションソースに移動し、新しいバージョンを作成します。
リソースセクションで、編集をクリックします。

リソースを更新モーダルから、必要なキースコープレベルドロップダウンを使用して、アプリケーションAPIキーのアクセスレベルを編集できます。キーの使用時にアプリケーションがDataRobotのパブリックAPIにアクセスできるレベルを定義するロールを選択します。

各ロールタイプには、次のアクセス権があります。

役割	アクセス
なし	アクセス権がない。このロールを選択すると、アプリケーションのAPIキーは提供されません。
閲覧者	読み取り専用
ユーザー	作成、読み取り、書き込み
管理	作成、読み取り、書き込み、削除

ロールを選択したら、更新をクリックします。設定したソースからアプリケーションを構築すると、選択したロールで定義されたアクセス範囲を持つアプリケーションAPIキーが自動的に提供されます。

ユーザーがアプリケーションにアクセスして使用すると、そのアプリケーションによって行われたリクエストのヘッダーにアプリケーションAPIキーが含まれます。

スコープ付きトークン¶

スコープ付きトークンを使うと、アプリケーションへのアクセス権をユーザーと共有する際に、権限やリソースを（ロールの形で）より細かく制御できます。

アプリケーションは、オーナーのAPIキー（DATAROBOT_API_TOKEN環境変数を使用）およびビジターのAPIキー（x-datarobot-api-keyリクエストヘッダーを使用）が使えるように設定できます。以下の例は、ローカル開発者によるスコープ付きトークンの操作をStreamlitとFastAPIの両方について示しています。

# Work with owner API key

endpoint = os.environ.get("DATAROBOT_ENDPOINT")
owner_api_key = os.environ.get("DATAROBOT_API_TOKEN")  # owner API key

with datarobot.Client(token=visitor_api_key, endpoint=endpoint) as client:
    deployments = datarobot.Deployment.list()  # get list of visitor datasets


# Work with visitor API key
## Streamlit

endpoint = os.environ.get("DATAROBOT_ENDPOINT")
headers = streamlit.context.headers  # request headers
visitor_api_key = headers.get('x-datarobot-api-key')  # visitor API key from request headers

with datarobot.Client(token=visitor_api_key, endpoint=endpoint) as client:
    datasets = datarobot.Dataset.list()  # get list of visitor datasets


## FastAPI

_router = fastapi.APIRouter(tags=["Datasets"])

@_router.get("/datasets")
async def chat_completion(request: fastapi.Request) -> Any:
    endpoint = os.environ.get("DATAROBOT_ENDPOINT")
    visitor_api_key = request.headers.get('x-datarobot-api-key')  # visitor API key from request headers

    with datarobot.Client(token=visitor_api_key, endpoint=endpoint) as client:
        datasets = datarobot.Dataset.list()  # get list of visitor datasets

ユースケースへのリンク¶

アプリケーションをワークベンチのユースケースにリンクするには、アプリケーションのアクションメニューで、 ユースケースへのリンクをクリックします。

ユースケースへのリンクモーダルで、次のいずれかのオプションを選択します。

ユースケースの選択ユースケースの作成リンクされたユースケースの管理

オプション	説明
ユースケースの選択	ユースケース名ドロップダウンリストをクリックして既存のユースケースを選択してから、ユースケースへのリンクをクリックします。
ユースケースの作成	新しいユースケース名とオプションの説明を入力し、ユースケースの作成をクリックして、ワークベンチで新しいユースケースを作成します。
リンクされたユースケースの管理	ユースケースの横にあるマイナスアイコンをクリックしてアセットとのリンクを解除してから、選択されたリンクを解除をクリックします。

アプリケーションの削除¶

適切な権限がある場合、アクションメニュー をクリックし、削除（）をクリックすることで、アプリケーションを削除できます。

アプリケーションを管理¶

アプリケーションの共有¶

アプリケーションのAPIキー¶

スコープ付きトークン¶

ユースケースへのリンク¶

アプリケーションの削除¶