এই পাতাটি ডেভেলপারদের জন্য। আপনার প্রতিষ্ঠানের লগ-ইন একটি প্রমিত পদ্ধতি OAuth ২. ০ এবং OpenID সংযোগ প্রদানকারী, যাতে যেকোন অ্যাপলিকেশন অথবা টুল আপনার ব্যবহারকারীদের Kamo অ্যাকাউন্ট ব্যবহার করে লগ-ইন করতে পারে এবং, তাদের অনুমতিক্রমে, API এবং Kamo MCP সার্ভারের মাধ্যমে তাদের Kamo তথ্যের সাথে কাজ করতে পারে। এখানে কোনো কিছুই একটি নির্দিষ্ট বিক্রেতা অথবা একটি নির্দিষ্ট ধরনের অ্যাপলিকেশনের জন্য নির্দিষ্ট নয়।
আরম্ভ করার পূর্বে
- একটি অ্যাডমিনস্ট্রেটর খোলে বৈশিষ্ট্য, তাহলে নিরাপত্তা, পরিচয় & লগ- ইন, সংযুক্ত অ্যাপলিকেশন, এবং আপনার অ্যাপলিকেশন সংযুক্ত করে (দেখুন একটি অ্যাপলিকেশন সংযুক্ত করুন) তারা একটি পায় ক্লায়েন্ট আই- ডি, এবং একটি ওয়েবসাইটের জন্য গোপনীয় ক্লায়েন্ট, একবার দেখানো হয়েছে ।
- আপনার অ্যাপ অন্যান্য সবকিছু পড়ে আবিষ্কারের ঠিকানা উদাহরণস্বরূপ, অ্যাপলিকেশনের কার্ডে
https://login.yourcompany.com/.well-known/openid-configurationতাদের নিজস্ব ওয়েব ঠিকানা না থাকা সংস্থাগুলোর জন্য রয়েছে এই ধরনের একটিhttps://login.kamouniverse.com/o/<organization number>/.well-known/openid-configuration. এই পৃষ্ঠায় প্রতিটি অন্যান্য ঠিকানা শুরু হয় যে একই প্রদানকারী.
অনুমতি (পরিধি)
একটি অ্যাপলিকেশন অনুমতির জন্য অনুরোধ করেছে scope. লগ- ইন করার অনুমতি হল openid (সদা প্রয়োজনীয়), profile, email, phone, kamo.org, kamo.roles এবং offline_access (একটি রিফ্রেশ টোকেনের সাথে সংযুক্ত থাকুন) ।
নিম্নলিখিত ডাটা অনুমতি অনুযায়ী অ্যাপলিকেশনটি অন্য কারো পক্ষে API ব্যবহার করতে পারবে। প্রত্যেকটি অনুমতির জন্য এই ব্যক্তির Kamo অনুমতি রয়েছে। একটি অ্যাপলিকেশন কখনোই Kamo-এ ব্যক্তির দ্বারা করা সম্ভবের চেয়ে বেশি কিছু করতে পারে না: যখন একটি টোকেন প্রদান করা হয়, তখন এটি শুধুমাত্র সেই ব্যক্তির Kamo অনুমতির ডাটা অনুমতি বহন করে, এবং প্রতিটি কল পুনরায় পরীক্ষা করা হয় সেই মুহূর্তে তাদের যা আছে তার সাথে। মুছে ফেলা কখনোই একটি অ্যাপলিকেশনের জন্য উপলব্ধ নয়।
পরিধি | এটা কি অনুমতি দেয় | Kamo অনুমতি প্রয়োজন (কোনো একটি) |
|---|---|---|
| পরিচিতি এবং তাদের বিস্তারিত তথ্য পড়ুন | পরিচিতি প্রদর্শন করুন |
| পরিচিতি তৈরি করুন এবং তাদের বিবরণ সম্পাদন করুন | পরিচিতি তৈরি করুন, পরিচিতি সম্পাদন করুন |
| আপনি দেখতে পাচ্ছেন, তাদের অবস্থা এবং ইতিহাসের সাথে লিড পড়ুন | লিড দেখাও |
| লিড তৈরি করুন, তাদের সম্পাদনা করুন এবং পাইপলাইনের মাধ্যমে তাদের সরিয়ে নিন | লিড তৈরি করুন, লিড সম্পাদন করুন, লিড মঞ্চ সরিয়ে নিন |
| আপনার ক্যালেন্ডার এবং এর ঘটনা পড়ুন | ক্যালেন্ডার প্রদর্শন করুন |
| আপনার ক্যালেন্ডারে ইভেন্ট তৈরি এবং পরিবর্তন করুন | ক্যালেন্ডার প্রদর্শন করুন |
| Kamo-এ যে মেইলবক্সগুলো খোলা যাবে তা পড়া হবে | মেইল প্রবেশ করান |
| আপনি যে মেইলবক্সগুলি ব্যবহার করতে পারেন সেগুলি থেকে ই-মেইল লিখুন এবং প্রেরণ করুন | মেইল প্রবেশ করান |
| আপনার নোট এবং চেকলিস্ট পড়ুন | নোট, কাজ প্রদর্শন করুন |
| নোট এবং চেকলিস্ট তৈরি এবং সম্পাদন করুন | নোট তৈরি করুন, নোট সম্পাদন করুন |
| আপনি যে নথি এবং ফাইলগুলো খুলতে পারেন সেগুলো পড়ুন | নথি প্রদর্শন |
| নথি আপলোড এবং সম্পাদন করুন | নথি তৈরি করুন, নথি সম্পাদন করুন |
| আপনার সংস্থার জ্ঞান ভিত্তিক বার্তা পড়ুন | কে. বি. বার্তা দেখাও |
| জ্ঞান ভিত্তিক বার্তা তৈরি এবং সম্পাদন করুন | কে. বি. বার্তা তৈরি করো, কে. বি. বার্তা সম্পাদন করো |
| আপনার সভা এবং তাদের বিবরণ পড়ুন | সভা প্রদর্শন করুন |
| সভা নির্ধারণ, পরিবর্তন এবং আরম্ভ করুন | সভা আরম্ভ করুন, সভা পরিচালনা করুন |
একই তালিকা, সবসময় বর্তমান, আছে https://api.<your domain>/api/security/oidc/scopes- আচ্ছা write অনুমতি অ্যাপলিকেশনকে একই ধরনের তথ্য পড়তে দেয়।
একটি অ্যাপলিকেশন কেবলমাত্র অনুমতির জন্য অনুরোধ করতে পারে যা এটিকে দেওয়া হয়েছে। অ্যাপলিকেশনটি সংযুক্ত করার সময় আপনার প্রশাসক এগুলি বেছে নেন: নিম্নলিখিত লগ-ইনগুলি এটি যা দেখতে পারে, ডাটা গুলো নিচে Kamo ডাটা সহযোগে কাজ করুন, এক দেখুন এবং এক পরিবর্তন প্রতিটি ধরনের তথ্যের জন্য পরিবর্তন করুন, প্রত্যেকটি 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.
আপনার অ্যাপলিকেশন নিজেই নিবন্ধন করতে দিন
অ্যাডমিনস্ট্রেটর এটি সক্রিয় করলে অ্যাপলিকেশনগুলিকে নিজেদের মধ্যে সংযোগ করতে দিন (এই নিবন্ধটি দেখুন), একটি অ্যাপলিকেশন নিবন্ধন করতে পারে কেউ তা টাইপ না করে, আদর্শ নিবন্ধন অনুরোধ (আরএফসি ৭৫৯১) ব্যবহার করে। ঠিকানাটি আবিষ্কার নথিতে আছে 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. অপেক্ষা করা হচ্ছে মানে যে কেউ লগ-ইন করার পূর্বে সংযুক্ত অ্যাপলিকেশনে অ্যাডমিনস্ট্রেটরকে এটি অনুমোদন করতে হবে; তখন পর্যন্ত লগ-ইন প্রদর্শন করবে "এই অ্যাপলিকেশনটি অনুমোদনের অপেক্ষায়"। নিবন্ধন নিষ্ক্রিয় থাকলে ঠিকানা উত্তর প্রদান করবে 404.
AI সহায়ক অথবা MCP ক্লায়েন্টের সাথে সংযোগ স্থাপন করুন
Kamo MCP সার্ভারের অবস্থান হল https://api.yourcompany.com/mcpযেকোন MCP ক্লায়েন্ট যে MCP অনুমোদন সমর্থন করে সংযোগ করতে পারে: এর প্রথম কলে এটি পাবে 401 একটি দিয়ে WWW-Authenticate শীর্ষচরণ ইঙ্গিত করছে https://api.yourcompany.com/.well-known/oauth-protected-resource/mcp, যা আপনার সংস্থার লগ- ইনকে অনুমোদন সার্ভার হিসেবে নামকরণ করে। এরপর ক্লায়েন্ট নিজেই নিবন্ধন করে (যদি অনুমোদিত হয়) অথবা অ্যাডমিনস্ট্রেটর দ্বারা প্রদত্ত একটি ক্লায়েন্ট আই. ডি. ব্যবহার করে, ব্যক্তিকে উপরের মত লগ- ইন করে এবং পাঠায় Authorization: Bearer ACCESS_TOKEN প্রতিটি MCP অনুরোধের ক্ষেত্রে। এটি যে টুল ব্যবহার করতে পারে তা ঠিক সেই ব্যক্তির অনুমতি এবং টোকেনের পরিধি অনুমোদন করে।
একটি টিভি অথবা ডিভাইসে লগ-ইন করুন
কীবোর্ডবিহীন ডিভাইস ডিভাইস লগ-ইন ব্যবহার করে (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 প্রত্যেকবার ৫ সেকেন্ড অপেক্ষা করুন. কোড ১০ মিনিট স্থায়ী হয়.
কেউ যখন চলে যায়
একটি ব্যক্তির অ্যাক্সেস অপসারণ করা হচ্ছে Kamo তাদের টোকেন শেষ করে: এপিআই এবং এমসিপি সার্ভার তাদের জন্য উত্তর দেওয়া বন্ধ করে দেয় (এক মিনিটের মধ্যে), এবং রিফ্রেশ ব্যর্থ হয়। লোকেরা এছাড়াও একটি অ্যাপ্লিকেশন নিজেকে অপসারণ করতে পারে আমার প্রোফাইল, ব্যবহারযোগ্য অ্যাপলিকেশন.
সংশ্লিষ্ট নিবন্ধ
অন্যান্য গাইড যেগুলো এই ধরনের প্রশ্নের উত্তর দেয়।
একটি অ্যাপলিকেশন সংযুক্ত করুন
একটি অ্যাপলিকেশন সংযুক্ত করতে সাতটি ছোট পদক্ষেপ নিতে হবে। খোলা বৈশিষ্ট্য, তাহলে নিরাপত্তা, নির্বাচন করুন পরিচয় & লগ- ইন, তাহলে সংযুক্ত অ্যাপলিকেশন, এবং চাপুন একটি অ্যাপলিকেশন সংযুক্ত করুনতোমার দরকার সংযুক্ত অ্যাপলিকেশন…
অ্যাপলিকেশনগুলিকে নিজেদের মধ্যে সংযোগ করতে দিন
কিছু অ্যাপলিকেশন, যেমন AI সহায়ক যা MCP এবং কমান্ড-লাইন টুল ব্যবহার করে, অ্যাডমিনস্ট্রেটর তাদের টাইপ করার পরিবর্তে আপনার সংস্থার লগ-ইন-এর সাথে নিজেদের সংযুক্ত করতে পারে। এটিকে বলা হয় ডাইনামিক নিবন্ধনএটাই বন্ধ যদি না তুমি…
সংযুক্ত অ্যাপলিকেশন
সংযুক্ত অ্যাপলিকেশন আপনার ব্যবহারকারীদের WordPress, Grafana, মুডল, নেক্সটক্লাউড অথবা আপনার নিজস্ব ওয়েবসাইটে Kamo অ্যাকাউন্ট ব্যবহার করে অন্যান্য ওয়েবসাইটে এবং অ্যাপলিকেশনে লগ-ইন করতে দেয়। এটি নিম্নরূপ কাজ করে Google…
ব্যবহারযোগ্য অ্যাপলিকেশন
আপনার সংস্থা আপনাকে আপনার সংস্থার অ্যাকাউন্ট ব্যবহার করে অন্যান্য ওয়েবসাইটে এবং অ্যাপ্লিকেশনে লগ-ইন করতে পারে, যেমন একটি কোম্পানির ব্লগ, ড্যাশবোর্ড অথবা একটি প্রশিক্ষণ সাইট। প্রথমবার আপনি এটি করলে, অ্যাপ্লিকেশনটি…
স্বয়ংক্রিয় সরবরাহ
স্বয়ংক্রিয় প্রদান আপনার পরিচয় সরবরাহকারীকে Kamo নিজে থেকে হালনাগাদ রাখতে দেয়। আপনার সরবরাহকারীতে কেউ যোগ করলে Kamo-এ তা প্রদর্শিত হয়, তার কাজের শিরোনাম বা বিভাগের পরিবর্তন হলে তা অনুসরণ করা হয়, এবং আপনার সরবরাহকারী থেকে…
