இந்த பக்கம் உருவாக்குவோருக்கானது. உங்கள் நிறுவனத்தின் நுழைவு நிலையானது OAuth 2.0மற்றும் 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. இந்த பக்கத்தில் உள்ள மற்ற எல்லா முகவரிகளும் அதே தகவலை துவக்குகின்றன வெளியீட்டாளர்.
அனுமதிகள் (அளவுகள்)
ஒரு பயன்பாடு அனுமதிகளை கோருகிறதுName scope. நுழைவு அனுமதிகள் openid (எப்பொழுதும் தேவை), profile, email, phone, kamo.org, kamo.roles மற்றும் offline_access (புதுப்பித்தல் குறியீட்டின் மூலம் இணைக்கப்பட்டிருக்கவும்)
கீழே உள்ள தரவு அனுமதிகள் ஒரு பயன்பாட்டை ஒருவரின் பெயரில் API ஐ பயன்படுத்த அனுமதிக்கிறது. ஒவ்வொன்றும் Kamo அனுமதிகளை அந்த நபர் ஏற்கனவே கொண்டுள்ளார். ஒரு பயன்பாடு Kamo இல் ஒருவர் செய்யக்கூடியதை விட அதிகமாக எப்போதும் செய்ய முடியாது: ஒரு டாக்கன் வெளியிடப்பட்டால் அது தகவலின் அனுமதிகளை மட்டுமே கொண்டு செல்கிறது, அந்த Kamo அனுமதிகளை அந்த நபர் உடனடியாக வைத்திருக்கிறார், மேலும் ஒவ்வொரு அழைப்புகளும் அந்த நேரத்தில் அவர்கள் வைத்திருப்பதை ஒப்பிட்டு மீண்டும் சரிபார்க்கப்படுகிறது. நீக்குதல் ஒரு பயன்பாட்டிற்கு எப்போதும் கிடைக்காது.
அளவு | இது அனுமதிப்பதை | Kamo அனுமதி தேவைப்படுகிறது (எந்தவொரு) |
|---|---|---|
| தொடர்புகளையும் அதன் விவரங்களையும் படிக்கவும் | தொடர்புகளைக் காட்டு |
| தொடர்புகளை உருவாக்கவும் அவற்றின் விவரங்களை தொகுக்கவும்Name | தொடர்புகளை உருவாக்கு, தொடர்புகளை திருத்து |
| தங்கள் நிலை மற்றும் வரலாற்றுடன், நீங்கள் பார்க்கக்கூடிய வழிகளை படிக்கவும் | தலைப்புகளைக் காட்டு |
| வழிகளை உருவாக்கவும், அவற்றை தொகுக்கவும், குழாய் வழியாக அவற்றை நகர்த்தவும்Name | தலைப்புகளை உருவாக்கு, தலைப்புகளை தொகு, தலைப்பு நிலையை நகர்த்து |
| உங்கள் நாட்காட்டி மற்றும் அதன் நிகழ்வுகளை படிக்கவும்Name | நாள்காட்டியை காட்டு |
| உங்கள் நாட்காட்டியில் நிகழ்வுகளை உருவாக்கவும் மாற்றவும்Name | நாள்காட்டியை காட்டு |
| Kamo இல் திறக்கக்கூடிய அஞ்சல் பெட்டிகளை படிக்கவும் | அஞ்சலை அணுகு |
| நீங்கள் பயன்படுத்தக்கூடிய அஞ்சல் பெட்டிகளிலிருந்து மின்னஞ்சல்களை எழுதவும் அனுப்பவும்Name | அஞ்சலை அணுகு |
| உங்கள் குறிப்புகளையும் சரிபார்ப்பு பட்டியலையும் படிக்கவும்Name | குறிப்புகளைக் காட்டு, பணிகளைக் காட்டு |
| குறிப்புகளையும் சரிபார்ப்பு பட்டியலையும் உருவாக்கவும் தொகுக்கவும் | குறிப்புகளை உருவாக்கு, குறிப்புகளை தொகு |
| நீங்கள் திறக்கக்கூடிய ஆவணங்கள் மற்றும் கோப்புகளை படிக்கவும் | ஆவணங்களைக் காட்டு |
| ஆவணங்களை ஏற்றவும் அவற்றை தொகுக்கவும் | ஆவணங்களை உருவாக்கு, ஆவணங்களை திருத்துName |
| உங்கள் நிறுவனத்தின் அறிவு அடிப்படை கட்டுரைகளை படிக்கவும் | KB கட்டுரைகளைக் காட்டு |
| தகவல்தள கட்டுரைகளை உருவாக்கவும் தொகுக்கவும்Name | KB கட்டுரைகளை உருவாக்கு, KB கட்டுரைகளை தொகு |
| உங்கள் சந்திப்புகள் மற்றும் அவற்றின் விவரங்களை படிக்கவும் | சந்திப்புகளைக் காட்டு |
| சந்திப்புகளை திட்டமிடு, மாற்று மற்றும் துவக்கு | சந்திப்பை தொடங்கு, சந்திப்பை நிர்வகி |
அதே பட்டியல், எப்போதும் தற்போதைய, உள்ளது 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.
உங்கள் பயன்பாடு தன்னை பதிவுசெய்யட்டும்
ஒரு நிர்வாகியால் இயக்கப்பட்டிருந்தால் பயன்பாடுகள் தாங்களே இணைய அனுமதி (அந்த கட்டுரையைப் பாருங்கள்), ஒரு பயன்பாடு யாரும் தட்டச்சு செய்யாமல் பதிவு செய்ய முடியும், தரமான பதிவு கோரிக்கையைப் பயன்படுத்தி (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. எதிர்பாராத ஒரு நிர்வாகியால் இணைக்கப்பட்ட பயன்பாடுகளில் அனுமதிக்க வேண்டும், யாரும் நுழைவதற்கு முன்; அப்போது வரை நுழைவது "இந்த பயன்பாடு அனுமதிக்காக காத்திருக்கிறது" என்பதை காட்டும். பதிவு செய்யப்படாவிட்டால் முகவரி பதில்கள் 404.
ஒரு AI உதவியாளர் அல்லது MCP உறுப்பினரை இணை
MCP சேவையகம் Kamo இல் உள்ளது 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, then poll every 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 சேவையகம் அவர்களுக்கு பதில் அளிப்பதை உடனடியாக நிறுத்துகிறது (ஒரு நிமிடத்திற்குள்), மேலும் புதுப்பித்தல் தோல்வியடைகிறது. மக்கள் ஒரு பயன்பாட்டை தாங்களே நீக்கலாம் என் விவரக்குறிப்பு, அணுகல் உள்ள பயன்பாடுகள்.
தொடர்புடைய கட்டுரைகள்
மற்ற வழிகாட்டிகள் இந்த ஒன்றிற்கு நெருக்கமான கேள்விகளுக்கு பதில் அளிக்கின்றன.
ஒரு பயன்பாட்டை இணை
ஒரு பயன்பாட்டை இணைக்க ஏழு குறுகிய படிகள் தேவை. திற அமைப்புகள், பிறகு பாதுகாப்பு, தேர்ந்தெடு அடையாளம் & நுழைவு, பிறகு இணைக்கப்பட்ட பயன்பாடுகள், மற்றும் அழுத்தவும் ஒரு பயன்பாட்டை இணைநீங்கள் தேவை இணைக்கப்பட்ட பயன்பாடுகளை…
பயன்பாடுகள் தாங்களே இணைய அனுமதி
சில பயன்பாடுகள், எம்சிபி மற்றும் கட்டளை-வரி கருவிகளை பயன்படுத்தும் AI உதவியாளர்கள் போன்றவை, நிர்வாகியால் தட்டச்சு செய்யப்படுவதை விட உங்கள் நிறுவனத்தின் நுழைவுடன் தாங்களே இணைக்க முடியும். இது அழைக்கப்படுகிறது இயங்குநிலை…
இணைக்கப்பட்ட பயன்பாடுகள்
இணைக்கப்பட்ட பயன்பாடுகள் உங்கள் மக்கள் மற்ற இணையத்தளங்கள் மற்றும் பயன்பாடுகளில் WordPress, Grafana, Moodle, Nextcloud அல்லது உங்கள் சொந்த இணையத்தளம் போன்றவற்றில் Kamo கணக்குடன் நுழைய அனுமதிக்கிறது. இது பின்வருமாறு…
அணுகல் உள்ள பயன்பாடுகள்
உங்கள் நிறுவனம் உங்களை உங்கள் நிறுவன கணக்குடன் மற்ற இணையத்தளங்கள் மற்றும் பயன்பாடுகளில் நுழைய அனுமதிக்கலாம், உதாரணமாக ஒரு நிறுவனப் பகிர்வு, டேஷ்போர்டுகள் அல்லது பயிற்சி தளம். நீங்கள் முதலில் செய்யும் போது, பயன்பாடு என்ன…
தானாகவே வழங்குதல்
தானாகவே வழங்குதல் உங்கள் அடையாள வழங்குநரை Kamo தன்னிச்சையாக புதுப்பிக்க அனுமதிக்கிறது. உங்கள் வழங்குநரில் சேர்க்கப்பட்டவர் Kamo இல் தோன்றும், அவர்களின் பணிப் பெயர் அல்லது பிரிவில் மாற்றம் ஏற்பட்டால், அதனை பின்பற்றவும்,…
