このページは開発者向けです。あなたの組織のログインは標準です OAuth 2.0と OpenID 接続 プロバイダのアカウントにログインできるようにするために、アプリケーションやツールは Kamo のアカウントでログインし、 API と Kamo の MCP サーバを通じて Kamo のデータと共に作業できます。 ここでは、どんなものもベンダーまたはアプリケーションの種類に特有のものではありません。
ビフォア・ユー・スタート
- 管理者が開く 設定じゃあ 安全保障, 個人情報とログイン, 接続されたアプリケーションあなたのアプリを接続します アプリケーションを接続彼らは クライアントIDウェブサイトの場合は 秘密のクライアント1回だけ見せた。
- あなたのアプリは他のすべてを ディスカバリー・アドレス 例えばアプリのカードには
https://login.yourcompany.com/.well-known/openid-configuration独自のウェブアドレスを持たない組織はhttps://login.kamouniverse.com/o/<organization number>/.well-known/openid-configurationこのページの他の全てのアドレスは 同じで始まります 発行者.
権限 (スコープ)
アプリケーションが権限を要求しましたName scopeログイン権限は openid (いつも必要な) profile, email, phone, kamo.org, kamo.roles そして offline_access (リフレッシュトークンで接続を維持)
以下のデータ権限は、アプリケーションが誰かの代わりに API を使用できるようにします。それぞれの権限は、その人が既に持っている権限 Kamo を表します。 アプリケーションは Kamo で自分ができる以上のことはできませんトークンが発行されたときは、当時 Kamo の権限を持っていたデータの権限のみを持ち、毎回のコールはその時点で持っていた権限と比較されます。アプリケーションは削除できません。
範囲 | 何を可能にするのか | Kamo の権限が必要です (いずれか) |
|---|---|---|
| 連絡先とその詳細を読み込みます | 連絡先を表示 |
| 連絡先を作成し、詳細を編集しますName | 連絡先を作成、編集 |
| リードの状態と履歴を読み込みます | リードを表示 |
| リードを作成し、編集し、パイプラインを通して移動します | リードを作成、リードを編集、リードステージを移動 |
| カレンダーとそのイベントを読みますName | カレンダーを表示 |
| カレンダーのイベントを作成し変更します | カレンダーを表示 |
| Kamo で開けるメールボックスを読み込む | アクセスメール |
| 使用可能なメールボックスからメールを作成し送信しますName | アクセスメール |
| メモとチェックリストを読む | メモを表示、タスクを表示 |
| メモやチェックリストを作成・編集します | メモを作成、編集 |
| 開くことができる文書とファイルを読み込みます | 文書を表示 |
| 文書をアップロードして編集します | 文書作成、文書編集 |
| 組織の知識ベースの記事を読む | KB 記事を表示 |
| 知識ベース記事の作成と編集 | KB 記事を作成、KB 記事を編集 |
| あなたの会議とその詳細を読むName | 会議を表示 |
| スケジュール、変更、および会議の開始 | 会議を開始、管理 |
常に最新の同じリストは https://api.<your domain>/api/security/oidc/scopesこんにちは write 同じデータを読むこともできるのです
アプリケーションは与えられた権限のみを要求できます。管理者はアプリケーションを接続するときにこれらを選択します。ログイン用の権限は次のとおりです ワット・イット・キャン・シー下のデータは Kamo のデータで作業1つ 海 1つ目は 変更 Kamo の権限を必要とするデータの種類ごとに切り替えます。 要求された範囲を正確に切り替えてもらいます。 アプリケーションに与えられていない範囲を切り替えてもらうと以下の場合に失敗します invalid_scope.
誰かにログイン (PKCE による認証コード)
PKCE チャレンジとともに認証アドレスに人物のブラウザを送信:
https://login.yourcompany.com/oauth/authorize?response_type=code&client_id=YOUR_CLIENT_ID
&redirect_uri=https%3A%2F%2Fapp.example.com%2Fcallback&scope=openid%20profile%20contacts.read%20offline_access
&state=RANDOM&code_challenge=BASE64URL_SHA256_OF_VERIFIER&code_challenge_method=S256ログインして アプリの要求を見て 許可あなたのリダイレクトアドレスは code, state そして issコードをトークンと交換する:
curl -X POST https://login.yourcompany.com/oauth/token \
-u YOUR_CLIENT_ID:YOUR_CLIENT_SECRET \
-d grant_type=authorization_code -d code=THE_CODE \
-d redirect_uri=https://app.example.com/callback -d code_verifier=THE_VERIFIER秘密を守れないアプリケーション (シングルページ、モバイル、デスクトップ、コマンドライン) を送信 client_id=YOUR_CLIENT_ID 代わりに -u答えは access_token (それは)持ち主の証しである id_token (サイン入り) refresh_token あなたと一緒に offline_access)と scope (トークンが実際に持っているもの)です
APIを呼び出す
アクセストークンを組織の API アドレスに送信:
curl https://api.yourcompany.com/api/contacts -H "Authorization: Bearer ACCESS_TOKEN"- 401 あなたと
WWW-Authenticate: Bearer error="invalid_token": トークンが有効期限を過ぎたり、取り消されたり、またはアクセス権限を失った人物です。更新または再ログインしてください。 - 403 あなたと
error="insufficient_scope", scope="contacts.write": トークンにはアドレスに必要な権限がありません。ログイン時に問い合わせてください。 - レディング
GET必要なのはreadデータの必要性を変えるものはwrite.
アプリケーションを自動的に登録させる
管理者がこの機能を有効にした場合 アプリケーションが自動的に接続するようにする 標準の登録要求 (RFC 7591) を使って、誰も入力せずにアプリケーションを登録できます。アドレスは、発見文書に次のように記載されています registration_endpoint:
curl -X POST https://login.yourcompany.com/oauth/register -H "Content-Type: application/json" -d '{
"client_name": "My Tool", "redirect_uris": ["http://127.0.0.1:33418/callback"],
"token_endpoint_auth_method": "none", "grant_types": ["authorization_code", "refresh_token"],
"scope": "openid contacts.read leads.read offline_access" }'答えはあなたにある client_id そして client_secret 保持しているアプリの場合) kamo_status. 待機中 すべてのユーザがログインする前に管理者が Connected Apps で承認しなければなりません。それまではログイン時に "This app is waiting for approval" と表示されます。登録がオフになると、アドレスが返信します 404.
AI アシスタントまたは MCP クライアントを接続
MCP サーバ Kamo はここにあります https://api.yourcompany.com/mcpMCP 認証をサポートするすべての MCP クライアントは接続できます 401 あなたは WWW-Authenticate ヘッダが https://api.yourcompany.com/.well-known/oauth-protected-resource/mcpクライアントは自分自身を登録するか、管理者が与えたクライアント ID を使用して、上記のようにログインし、認証サーバに対して認証コードを送信します Authorization: Bearer ACCESS_TOKEN それが使えるツールは 人間の権限と トークンの範囲が許すものです
テレビやデバイスでログイン
キーボードがないデバイスは、デバイスログイン (RFC 8628) を使用します。このアプリケーションには、キーボードが必要です テレビまたはデバイス デバイスのログインを有効にするには、次のコマンドを入力してください。
curl -X POST https://login.yourcompany.com/oauth/device_authorization -d client_id=YOUR_CLIENT_ID -d "scope=openid profile"人に見せる user_code まるで WDJB-MJHTまた verification_uriそれから毎回 interval 秒数:
curl -X POST https://login.yourcompany.com/oauth/token -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
-d device_code=THE_DEVICE_CODE -d client_id=YOUR_CLIENT_ID答えが である限り投票を続ける authorization_pending; オン slow_down 毎回5秒待ってください コードは10分間有効です
ワン・ソーネ・リーズ
Kamo でアプリケーションのアクセスを削除すると、そのアプリケーションのトークンが終了します。APIと MCP サーバは一時的に (1 分以内) 応答を停止し、更新に失敗します。アプリケーションは {1} で自分で削除することもできます 私のプロフィール, アクセスのあるアプリケーション.
関連記事
これに近い質問に答える他のガイド。
アプリケーションを接続
アプリケーションを接続するには7つの簡単なステップが必要です。 開く 設定じゃあ 安全保障選択 個人情報とログインじゃあ 接続されたアプリケーションそして 押して アプリケーションを接続必要なのは 接続されたアプリケーションの管理 許可を 何も保存されません アプリケーションを接続 ステップ6で 誰も影響を受けない 誰かがアプリにログインするまで アプリケーションを接続 ステップ 2, 4, 6…
アプリケーションが自動的に接続するようにする
MCPやコマンドラインツールを使用するアシスタント AI のようなアプリケーションは、管理者が入力する代わりに自動的に組織のログインに接続できます。これは、自動ログインと呼ばれます ダイナミック登録それは オフ スイッチを入れない限り ウェア・イット・イズ オープン 設定じゃあ 安全保障選択 個人情報とログインじゃあ 接続されたアプリケーション必要なのは 接続されたアプリケーションの管理…
接続されたアプリケーション
Connected Apps を使えば、 WordPress, Grafana, Moodle, Nextcloud などの他のウェブサイトやアプリケーション、または自分のウェブサイトに、既存の Kamo アカウントでログインできます Google でログインアカウントとパスワードは 組織のものだ 組織を離れたら アプリにログインできない 接続されたアプリケーション オープン 設定じゃあ 安全保障選択 個人情報とログインじゃあ…
アクセスのあるアプリケーション
あなたの組織は、会社のブログ、ダッシュボード、訓練サイトなどの他のウェブサイトやアプリケーションに、あなたの組織のアカウントでログインできるようにします。最初にログインすると、アプリケーションは何を見ることができるかを尋ね、あなたが何を見るべきかを選択します 許可 もしくは 許可しない. アクセスのあるアプリケーション 許可したアプリケーションはすべてプロフィールに表示されます。画像を開き、 私のプロフィールここに来てくれ アクセス…
自動プロビジョニング
自動プロビジョニングを使えば、ID プロバイダが Kamo プロバイダに追加された人は プロバイダのメールに表示されます Kamo職務や部署が変わり プロバイダから削除された人は 解雇される Kamo背後にある標準は SCIM. 自動プロビジョニング オープン 設定じゃあ 安全保障選択 個人情報とログインじゃあ プロビジョニング必要なのは ID プロバイダの管理 プロビジョニングは ID プロバイダの接続を通して行われますので、まず…
