Learn365 API キーの管理

Learn365 では、Microsoft 365 グローバル管理者、SharePoint 管理者、LMS 管理者が、Learn365 API キーを作成（生成）できます。

API キーは用途ごとに個別に管理できます。特定の用途に使われているキーだけを取り消すことができるので、重要な連携を崩すことなく運用できます。

各キーには「読み取り専用」または「フルコントロール」の権限を付与でき、キーごとに利用範囲を制限できます。

ここでは、Learn365 API キーの生成と管理について説明します。

ここで説明する操作を行うには、Microsoft 365 グローバル管理者、SharePoint 管理者、または LMS 管理者ロールが必要です。

API キーを管理する場所

API キーは Learn365 管理センター＞グローバル設定＞管理＞「API キー管理」で一元管理します。

API キー管理ページでは、以下のことができます。

API キー管理ぺージには、次の情報が表示されます。

特定の API キーを見つけるには、検索フィールドを使うか、「作成者」、「失効者」の列見出しにあるフィルターアイコンを選択してフィルターを適用します。

生成の手順：

1．「＋API キーを生成」を選択します。「API キーの生成」パネルが開きます。

2．「API キーの生成」パネルで以下を設定します。

名前：識別しやすい名称を入力します。
権限 / アクセスの種類：「読み取り専用」または「フルコントロール」を選択します。
- 読み取り専用：Learn365 ソリューションのデータの読み取りのみができます。この権限の API キーでは、更新・作成・削除はできません。読み取り専用キーで更新・作成・削除を試みた場合、処理は失敗します。
- フルコントロール：Learn365 ソリューションのデータの読み取り・更新・作成・削除ができます。

重要！

一度保存すると、「権限 / アクセスの種類」は変更できません。

必要に応じて「API キー」フィールドのコピーアイコンを選択して、API キーをクリップボードへコピーします。

3．保存します。生成されたキーが、API キー管理ぺージの一覧に追加されます。

「API キー管理」ページでは、API キーの編集や取り消しができます。

対象の API キーを選択し、開いたパネルで該当のオプションを選択します。

API キーは「名前」のみ編集（変更）できます。

編集の手順：

1．「編集 API キー」を選択します。「編集 API キー」パネルが開きます。

2．API キーの「名前」を編集します。

3．保存します。

注記：

取り消し済み（ステータス「失効」）の API キーは編集できません。

重要！

この操作は元に戻せません。

API キーを取り消すと、そのキーを使用しているすべてのフローや接続（例：Power BI、Power Automate で作成した連携）は動作を停止します。

取り消しの手順：

1．「API キーを取り消す」を選択します。

2．確認ダイアログが表示されます。

確認メッセージを読み、続行する場合はチェックボックスをオンにします。これにより、「取消し」ボタンが有効になります。

3．「取消し」を選択して操作を確定します。操作を中止する場合は「キャンセル」を選択します。