GET/api/sso/:tenantSlug/saml/metadata
உங்கள் அடையாள வழங்குநரில் இறக்குமதி செய்ய Zentor App-இன் SAML மெட்டாடேட்டாவை (XML) வழங்குகிறது.
மெட்டாடேட்டாவில் Entity-ID மற்றும் உங்கள் அடையாள வழங்குநருக்கு அமைப்பிற்குத் தேவையான ACS-URL ஆகியவை அடங்கும். பதில் ஒரு XML ஆவணம், JSON அல்ல. கணக்கிற்கு SAML அமைக்கப்படாவிட்டால், சர்வர் 404 `SSO_NOT_CONFIGURED` உடன் பதிலளிக்கும்.
கண்ணோட்டம்
அழைப்பு: GET /api/sso/:tenantSlug/saml/metadata. இந்த எண்ட்பாயிண்ட் Zentor App API-யின் “டெமோ சாட்பாட் மற்றும் SSO” குழுவைச் சேர்ந்தது. இது பொதுவில் அணுகக்கூடியது; அங்கீகாரம் (authentication) தேவையில்லை. இந்த அழைப்பு idempotent ஆகும்: அதே உள்ளீடுகளுடன் மீண்டும் மீண்டும் அழைத்தால் அதே முடிவு கிடைக்கும். கட்டாய அளவுருக்கள்: tenantSlug (பாத்). ஆவணப்படுத்தப்பட்ட பிழை நிலைகள்: 404 -.
அங்கீகாரம் & பாதுகாப்பு
அங்கீகாரம் தேவையில்லை
Idempotent (மீண்டும் செய்தாலும் அதே விளைவு): ஆம்
அளவுருக்கள்
tenantSlug(path, string, கட்டாயம்)— SSO அமைக்கப்பட்டுள்ள கணக்கின் அடையாளம் (Slug)எடுத்துக்காட்டுப் பதில்
(SAML கணக்கிற்கு அமைக்கப்பட்டிருந்தால், SAML மெட்டாடேட்டா XML ஆவணமாக - JSON இல்லை)
பிழைக் குறியீடுகள்
404 - — இந்தக் கணக்கிற்கு SAML அமைக்கப்படவில்லை.சரிபார்க்கப்பட்ட நடத்தை
SAML இல்லாத கணக்கிற்கான மீட்பு 404 தரும்.
டெமோ சாட்பாட் மற்றும் SSO
POST /api/global-chatbot/demozentor-app.de/demo-இல் உள்ள பொது டெமோ சாட்பாட்டிற்கு ஒரு செய்தியை அனுப்பி, அதன் பதிலை வழங்குகிறது. பதிவு செய்யாமலேயே உலாவியில் டெமோவை முயற்சிக்கலாம்.GET /api/global-chatbot/demo/historyடெமோ உரையாடலின் முந்தைய செய்தி வரலாற்றை ஏற்றுகிறது, இதனால் டெமோவை மீண்டும் திறக்கும்போது அது பாதுகாக்கப்படும்.POST /api/global-chatbot/demo/pollடெமோ உரையாடலின் புதிய செய்திகளை பெறுகிறது, எடுத்துக்காட்டாக Zentor-இன் ஊழியர் ஒருவர் உரையாடலை எடுத்துக்கொண்டால். டெமோ பக்கம் இந்த இறுதிப்புள்ளியை இடைவெளிகளில் அழைக்கிறது.POST /api/global-chatbot/demo/ratingடெமோ உரையாடலின் மதிப்பீட்டை (பயனுள்ளது அல்லது பயனற்றது) விருப்ப கருத்துடன் சேமிக்கிறது.POST /api/global-chatbot/demo/trackZentor-இன் பார்வையாளர் புள்ளிவிவரங்களுக்காக டெமோ பக்கத்தின் அநாமதேய பயன்பாட்டு நிகழ்வுகளைப் பதிவு செய்கிறது.POST /api/global-chatbot/demo/voice-transcribeடெமோ பக்கத்தில் உள்ள குரல் பதிவை உரையாக மாற்றுகிறது (குரல் உள்ளீடு), டெமோவின் குரல் வசதி செயலில் இருந்தால்.POST /api/global-chatbot/demo/voice-speakஉரையை பேச்சாக மாற்றுகிறது (டெமோ பக்கத்தில் குரல் வெளியீடு), டெமோவின் குரல் வசதி செயலில் இருந்தால்.GET /api/sso/:tenantSlug/statusஒரு கணக்கிற்கு ஒற்றை உள்நுழைவு (SAML அல்லது OIDC) அமைக்கப்பட்டுள்ளதா எனச் சரிபார்க்கிறது. உள்நுழைவு பக்கம் முடிவைப் பயன்படுத்தி SSO உள்நுழைவை வழங்குகிறது.GET /api/sso/:tenantSlug/oidc/startOpenID Connect மூலம் உள்நுழைவைத் தொடங்கி, உலாவியை உள்ளமைக்கப்பட்ட அடையாள வழங்குநருக்குத் திருப்பி விடுகிறது.GET /api/sso/:tenantSlug/oidc/callbackOIDC உள்நுழைவுக்குப் பிறகு அடையாள வழங்குநரின் திருப்பி விடலைப் பெற்று, உலாவியை Zentor App-க்குத் திருப்பி அனுப்புகிறது.GET /api/sso/:tenantSlug/saml/startSAML மூலம் உள்நுழைவைத் தொடங்கி, உலாவியை உள்ளமைக்கப்பட்ட அடையாள வழங்குநருக்குத் திருப்பி விடுகிறது.POST /api/sso/:tenantSlug/saml/acsஉறுதிநிலை நுகர்வோர் சேவை (ACS): அடையாள வழங்குநரின் கையொப்பமிடப்பட்ட SAML பதிலை படிவ POST மூலம் பெறுகிறது.