[{"data":1,"prerenderedAt":701},["ShallowReactive",2],{"help-article-settings-sso-configuration":3,"help-siblings-settings":649},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"category":5,"order":10,"difficulty":11,"time_to_complete":12,"related":13,"body":17,"_type":643,"_id":644,"_source":645,"_file":646,"_stem":647,"_extension":648},"\u002Fhelp\u002Fsettings\u002Fsso-configuration","settings",false,"","Configuring SSO (Google, Microsoft, GitHub)","How to set up Single Sign-On so your team can log in with their existing Google, Microsoft, or GitHub accounts.",8,"advanced","10 minutes",[14,15,16],"\u002Fhelp\u002Fgetting-started\u002Finvite-team","\u002Fhelp\u002Fsettings\u002Froles-permissions","\u002Fhelp\u002Fgetting-started\u002Fcreate-account",{"type":18,"children":19,"toc":625},"root",[20,29,35,42,158,164,171,186,192,284,290,295,301,306,319,324,407,413,486,492,532,538,543,576,582],{"type":21,"tag":22,"props":23,"children":25},"element","h1",{"id":24},"configuring-sso-single-sign-on",[26],{"type":27,"value":28},"text","Configuring SSO (Single Sign-On)",{"type":21,"tag":30,"props":31,"children":32},"p",{},[33],{"type":27,"value":34},"Let your team log in with their existing Google, Microsoft, or GitHub accounts — no separate password needed.",{"type":21,"tag":36,"props":37,"children":39},"h2",{"id":38},"supported-providers",[40],{"type":27,"value":41},"Supported providers",{"type":21,"tag":43,"props":44,"children":45},"table",{},[46,70],{"type":21,"tag":47,"props":48,"children":49},"thead",{},[50],{"type":21,"tag":51,"props":52,"children":53},"tr",{},[54,60,65],{"type":21,"tag":55,"props":56,"children":57},"th",{},[58],{"type":27,"value":59},"Provider",{"type":21,"tag":55,"props":61,"children":62},{},[63],{"type":27,"value":64},"Protocol",{"type":21,"tag":55,"props":66,"children":67},{},[68],{"type":27,"value":69},"Best for",{"type":21,"tag":71,"props":72,"children":73},"tbody",{},[74,97,117,137],{"type":21,"tag":51,"props":75,"children":76},{},[77,87,92],{"type":21,"tag":78,"props":79,"children":80},"td",{},[81],{"type":21,"tag":82,"props":83,"children":84},"strong",{},[85],{"type":27,"value":86},"Google",{"type":21,"tag":78,"props":88,"children":89},{},[90],{"type":27,"value":91},"OAuth 2.0",{"type":21,"tag":78,"props":93,"children":94},{},[95],{"type":27,"value":96},"Google Workspace teams",{"type":21,"tag":51,"props":98,"children":99},{},[100,108,112],{"type":21,"tag":78,"props":101,"children":102},{},[103],{"type":21,"tag":82,"props":104,"children":105},{},[106],{"type":27,"value":107},"Microsoft",{"type":21,"tag":78,"props":109,"children":110},{},[111],{"type":27,"value":91},{"type":21,"tag":78,"props":113,"children":114},{},[115],{"type":27,"value":116},"Microsoft 365 \u002F Azure AD teams",{"type":21,"tag":51,"props":118,"children":119},{},[120,128,132],{"type":21,"tag":78,"props":121,"children":122},{},[123],{"type":21,"tag":82,"props":124,"children":125},{},[126],{"type":27,"value":127},"GitHub",{"type":21,"tag":78,"props":129,"children":130},{},[131],{"type":27,"value":91},{"type":21,"tag":78,"props":133,"children":134},{},[135],{"type":27,"value":136},"Developer teams",{"type":21,"tag":51,"props":138,"children":139},{},[140,148,153],{"type":21,"tag":78,"props":141,"children":142},{},[143],{"type":21,"tag":82,"props":144,"children":145},{},[146],{"type":27,"value":147},"Custom OIDC",{"type":21,"tag":78,"props":149,"children":150},{},[151],{"type":27,"value":152},"OpenID Connect",{"type":21,"tag":78,"props":154,"children":155},{},[156],{"type":27,"value":157},"Enterprise identity providers",{"type":21,"tag":36,"props":159,"children":161},{"id":160},"setting-up-google-sso",[162],{"type":27,"value":163},"Setting up Google SSO",{"type":21,"tag":165,"props":166,"children":168},"h3",{"id":167},"prerequisites",[169],{"type":27,"value":170},"Prerequisites",{"type":21,"tag":172,"props":173,"children":174},"ul",{},[175,181],{"type":21,"tag":176,"props":177,"children":178},"li",{},[179],{"type":27,"value":180},"Google Cloud Console access",{"type":21,"tag":176,"props":182,"children":183},{},[184],{"type":27,"value":185},"A Google Cloud project",{"type":21,"tag":165,"props":187,"children":189},{"id":188},"steps",[190],{"type":27,"value":191},"Steps",{"type":21,"tag":193,"props":194,"children":195},"ol",{},[196,210,235,252,262,274,279],{"type":21,"tag":176,"props":197,"children":198},{},[199,201],{"type":27,"value":200},"Go to ",{"type":21,"tag":202,"props":203,"children":207},"a",{"href":204,"rel":205},"https:\u002F\u002Fconsole.cloud.google.com",[206],"nofollow",[208],{"type":27,"value":209},"Google Cloud Console",{"type":21,"tag":176,"props":211,"children":212},{},[213,215],{"type":27,"value":214},"Create OAuth 2.0 credentials:\n",{"type":21,"tag":172,"props":216,"children":217},{},[218,223],{"type":21,"tag":176,"props":219,"children":220},{},[221],{"type":27,"value":222},"Application type: Web application",{"type":21,"tag":176,"props":224,"children":225},{},[226,228],{"type":27,"value":227},"Authorized redirect URI: ",{"type":21,"tag":229,"props":230,"children":232},"code",{"className":231},[],[233],{"type":27,"value":234},"https:\u002F\u002Fapp.aisoule.com\u002Fapi\u002Fauth\u002Fsso\u002Fgoogle\u002Fcallback",{"type":21,"tag":176,"props":236,"children":237},{},[238,240,245,247],{"type":27,"value":239},"Copy the ",{"type":21,"tag":82,"props":241,"children":242},{},[243],{"type":27,"value":244},"Client ID",{"type":27,"value":246}," and ",{"type":21,"tag":82,"props":248,"children":249},{},[250],{"type":27,"value":251},"Client Secret",{"type":21,"tag":176,"props":253,"children":254},{},[255,257],{"type":27,"value":256},"In AIsoule, go to ",{"type":21,"tag":82,"props":258,"children":259},{},[260],{"type":27,"value":261},"Settings → SSO",{"type":21,"tag":176,"props":263,"children":264},{},[265,267,272],{"type":27,"value":266},"Click ",{"type":21,"tag":82,"props":268,"children":269},{},[270],{"type":27,"value":271},"\"Add Provider\"",{"type":27,"value":273}," → Google",{"type":21,"tag":176,"props":275,"children":276},{},[277],{"type":27,"value":278},"Paste Client ID and Client Secret",{"type":21,"tag":176,"props":280,"children":281},{},[282],{"type":27,"value":283},"Save",{"type":21,"tag":165,"props":285,"children":287},{"id":286},"testing",[288],{"type":27,"value":289},"Testing",{"type":21,"tag":30,"props":291,"children":292},{},[293],{"type":27,"value":294},"Click \"Login with Google\" on the login page to verify it works.",{"type":21,"tag":36,"props":296,"children":298},{"id":297},"setting-up-microsoft-sso",[299],{"type":27,"value":300},"Setting up Microsoft SSO",{"type":21,"tag":165,"props":302,"children":304},{"id":303},"prerequisites-1",[305],{"type":27,"value":170},{"type":21,"tag":172,"props":307,"children":308},{},[309,314],{"type":21,"tag":176,"props":310,"children":311},{},[312],{"type":27,"value":313},"Azure AD \u002F Microsoft Entra access",{"type":21,"tag":176,"props":315,"children":316},{},[317],{"type":27,"value":318},"An app registration in Azure",{"type":21,"tag":165,"props":320,"children":322},{"id":321},"steps-1",[323],{"type":27,"value":191},{"type":21,"tag":193,"props":325,"children":326},{},[327,340,364,380,388,398,403],{"type":21,"tag":176,"props":328,"children":329},{},[330,331,338],{"type":27,"value":200},{"type":21,"tag":202,"props":332,"children":335},{"href":333,"rel":334},"https:\u002F\u002Fportal.azure.com",[206],[336],{"type":27,"value":337},"Azure Portal",{"type":27,"value":339}," → App Registrations",{"type":21,"tag":176,"props":341,"children":342},{},[343,345],{"type":27,"value":344},"Create a new registration:\n",{"type":21,"tag":172,"props":346,"children":347},{},[348,359],{"type":21,"tag":176,"props":349,"children":350},{},[351,353],{"type":27,"value":352},"Redirect URI: ",{"type":21,"tag":229,"props":354,"children":356},{"className":355},[],[357],{"type":27,"value":358},"https:\u002F\u002Fapp.aisoule.com\u002Fapi\u002Fauth\u002Fsso\u002Fmicrosoft\u002Fcallback",{"type":21,"tag":176,"props":360,"children":361},{},[362],{"type":27,"value":363},"Supported account types: Choose based on your needs",{"type":21,"tag":176,"props":365,"children":366},{},[367,369,374,376],{"type":27,"value":368},"Copy ",{"type":21,"tag":82,"props":370,"children":371},{},[372],{"type":27,"value":373},"Application (client) ID",{"type":27,"value":375}," and create a ",{"type":21,"tag":82,"props":377,"children":378},{},[379],{"type":27,"value":251},{"type":21,"tag":176,"props":381,"children":382},{},[383,384],{"type":27,"value":256},{"type":21,"tag":82,"props":385,"children":386},{},[387],{"type":27,"value":261},{"type":21,"tag":176,"props":389,"children":390},{},[391,392,396],{"type":27,"value":266},{"type":21,"tag":82,"props":393,"children":394},{},[395],{"type":27,"value":271},{"type":27,"value":397}," → Microsoft",{"type":21,"tag":176,"props":399,"children":400},{},[401],{"type":27,"value":402},"Paste Client ID, Client Secret, and Tenant ID",{"type":21,"tag":176,"props":404,"children":405},{},[406],{"type":27,"value":283},{"type":21,"tag":36,"props":408,"children":410},{"id":409},"setting-up-github-sso",[411],{"type":27,"value":412},"Setting up GitHub SSO",{"type":21,"tag":193,"props":414,"children":415},{},[416,427,446,459,467,477,482],{"type":21,"tag":176,"props":417,"children":418},{},[419,420],{"type":27,"value":200},{"type":21,"tag":202,"props":421,"children":424},{"href":422,"rel":423},"https:\u002F\u002Fgithub.com\u002Fsettings\u002Fdevelopers",[206],[425],{"type":27,"value":426},"GitHub Developer Settings",{"type":21,"tag":176,"props":428,"children":429},{},[430,432],{"type":27,"value":431},"Create a new OAuth App:\n",{"type":21,"tag":172,"props":433,"children":434},{},[435],{"type":21,"tag":176,"props":436,"children":437},{},[438,440],{"type":27,"value":439},"Authorization callback URL: ",{"type":21,"tag":229,"props":441,"children":443},{"className":442},[],[444],{"type":27,"value":445},"https:\u002F\u002Fapp.aisoule.com\u002Fapi\u002Fauth\u002Fsso\u002Fgithub\u002Fcallback",{"type":21,"tag":176,"props":447,"children":448},{},[449,450,454,455],{"type":27,"value":368},{"type":21,"tag":82,"props":451,"children":452},{},[453],{"type":27,"value":244},{"type":27,"value":246},{"type":21,"tag":82,"props":456,"children":457},{},[458],{"type":27,"value":251},{"type":21,"tag":176,"props":460,"children":461},{},[462,463],{"type":27,"value":256},{"type":21,"tag":82,"props":464,"children":465},{},[466],{"type":27,"value":261},{"type":21,"tag":176,"props":468,"children":469},{},[470,471,475],{"type":27,"value":266},{"type":21,"tag":82,"props":472,"children":473},{},[474],{"type":27,"value":271},{"type":27,"value":476}," → GitHub",{"type":21,"tag":176,"props":478,"children":479},{},[480],{"type":27,"value":481},"Paste credentials",{"type":21,"tag":176,"props":483,"children":484},{},[485],{"type":27,"value":283},{"type":21,"tag":36,"props":487,"children":489},{"id":488},"how-sso-login-works",[490],{"type":27,"value":491},"How SSO login works",{"type":21,"tag":193,"props":493,"children":494},{},[495,507,512,517,522,527],{"type":21,"tag":176,"props":496,"children":497},{},[498,500,505],{"type":27,"value":499},"User clicks \"Login with ",{"type":21,"tag":501,"props":502,"children":503},"span",{},[504],{"type":27,"value":59},{"type":27,"value":506},"\" on the login page",{"type":21,"tag":176,"props":508,"children":509},{},[510],{"type":27,"value":511},"Redirected to the provider's login page",{"type":21,"tag":176,"props":513,"children":514},{},[515],{"type":27,"value":516},"User authenticates with their existing account",{"type":21,"tag":176,"props":518,"children":519},{},[520],{"type":27,"value":521},"Redirected back to AIsoule",{"type":21,"tag":176,"props":523,"children":524},{},[525],{"type":27,"value":526},"If the email matches an existing user → logged in",{"type":21,"tag":176,"props":528,"children":529},{},[530],{"type":27,"value":531},"If new email → account created automatically (if auto-provisioning is enabled)",{"type":21,"tag":36,"props":533,"children":535},{"id":534},"auto-provisioning",[536],{"type":27,"value":537},"Auto-provisioning",{"type":21,"tag":30,"props":539,"children":540},{},[541],{"type":27,"value":542},"When enabled, new users who log in via SSO are automatically created in AIsoule with a default role. Configure in SSO settings:",{"type":21,"tag":172,"props":544,"children":545},{},[546,556,566],{"type":21,"tag":176,"props":547,"children":548},{},[549,554],{"type":21,"tag":82,"props":550,"children":551},{},[552],{"type":27,"value":553},"Enabled",{"type":27,"value":555}," — New SSO users get auto-created",{"type":21,"tag":176,"props":557,"children":558},{},[559,564],{"type":21,"tag":82,"props":560,"children":561},{},[562],{"type":27,"value":563},"Default role",{"type":27,"value":565}," — What role they receive (e.g., Agent)",{"type":21,"tag":176,"props":567,"children":568},{},[569,574],{"type":21,"tag":82,"props":570,"children":571},{},[572],{"type":27,"value":573},"Disabled",{"type":27,"value":575}," — Only pre-existing users can log in via SSO",{"type":21,"tag":36,"props":577,"children":579},{"id":578},"tips",[580],{"type":27,"value":581},"Tips",{"type":21,"tag":193,"props":583,"children":584},{},[585,595,605,615],{"type":21,"tag":176,"props":586,"children":587},{},[588,593],{"type":21,"tag":82,"props":589,"children":590},{},[591],{"type":27,"value":592},"Test with one user first",{"type":27,"value":594}," — Verify the flow before rolling out to the team",{"type":21,"tag":176,"props":596,"children":597},{},[598,603],{"type":21,"tag":82,"props":599,"children":600},{},[601],{"type":27,"value":602},"Set a default role",{"type":27,"value":604}," — So auto-provisioned users have appropriate access",{"type":21,"tag":176,"props":606,"children":607},{},[608,613],{"type":21,"tag":82,"props":609,"children":610},{},[611],{"type":27,"value":612},"Keep password login",{"type":27,"value":614}," — As a backup in case SSO has issues",{"type":21,"tag":176,"props":616,"children":617},{},[618,623],{"type":21,"tag":82,"props":619,"children":620},{},[621],{"type":27,"value":622},"Use domain restriction",{"type":27,"value":624}," — Only allow emails from your company domain",{"title":7,"searchDepth":626,"depth":626,"links":627},2,[628,629,635,639,640,641,642],{"id":38,"depth":626,"text":41},{"id":160,"depth":626,"text":163,"children":630},[631,633,634],{"id":167,"depth":632,"text":170},3,{"id":188,"depth":632,"text":191},{"id":286,"depth":632,"text":289},{"id":297,"depth":626,"text":300,"children":636},[637,638],{"id":303,"depth":632,"text":170},{"id":321,"depth":632,"text":191},{"id":409,"depth":626,"text":412},{"id":488,"depth":626,"text":491},{"id":534,"depth":626,"text":537},{"id":578,"depth":626,"text":581},"markdown","content:help:settings:sso-configuration.md","content","help\u002Fsettings\u002Fsso-configuration.md","help\u002Fsettings\u002Fsso-configuration","md",[650,653,656,659,662,665,668,671,674,677,680,683,686,688,689,692,695,698],{"_path":651,"title":652},"\u002Fhelp\u002Fsettings\u002Fapi-keys","Setting up API keys for programmatic access",{"_path":654,"title":655},"\u002Fhelp\u002Fsettings\u002Faudit-logs","Understanding audit logs",{"_path":657,"title":658},"\u002Fhelp\u002Fsettings\u002Fbusiness-profile","Business profile settings",{"_path":660,"title":661},"\u002Fhelp\u002Fsettings\u002Fcanned-responses-management","Managing canned responses",{"_path":663,"title":664},"\u002Fhelp\u002Fsettings\u002Fcreating-templates","Creating and managing message templates",{"_path":666,"title":667},"\u002Fhelp\u002Fsettings\u002Fcustom-actions","Custom actions (webhook, URL, JavaScript)",{"_path":669,"title":670},"\u002Fhelp\u002Fsettings\u002Fdark-mode","Dark mode and theme settings",{"_path":672,"title":673},"\u002Fhelp\u002Fsettings\u002Flanguage-settings","Language settings (i18n)",{"_path":675,"title":676},"\u002Fhelp\u002Fsettings\u002Fmanaging-accounts","Managing WhatsApp Business accounts",{"_path":678,"title":679},"\u002Fhelp\u002Fsettings\u002Fmanaging-users","Managing users (invite, deactivate, roles)",{"_path":681,"title":682},"\u002Fhelp\u002Fsettings\u002Fnotification-preferences","Notification preferences",{"_path":684,"title":685},"\u002Fhelp\u002Fsettings\u002Frate-limiting","Rate limiting and API quotas",{"_path":15,"title":687},"Creating custom roles and permissions",{"_path":4,"title":8},{"_path":690,"title":691},"\u002Fhelp\u002Fsettings\u002Fteams-assignment","Setting up teams and assignment strategies",{"_path":693,"title":694},"\u002Fhelp\u002Fsettings\u002Ftemplate-approval-tips","Template approval process and best practices",{"_path":696,"title":697},"\u002Fhelp\u002Fsettings\u002Fwebhook-configuration","Configuring outbound webhooks",{"_path":699,"title":700},"\u002Fhelp\u002Fsettings\u002Fwhatsapp-flows","WhatsApp Flows (Meta Flows) management",1780423185275]