Mag-login gamit ang company account at
awtomatikong papasok ang mga tao

Papapasukin ang mga tao sa Modak gamit ang account na ginagamit ng kumpanya tulad ng Okta · Microsoft Entra ID · Google Workspace (IdP) (SAML SSO), at awtomatikong gagawin at ilalabas ang mga tao at team sa pamamagitan ng directory sync (SCIM). Pareho ito sa ginamit mo sa Slack. Itinatakda ito ng admin ng workspace.

1 Paghahanda 2 Beripikasyon ng domain 3 Irehistro ang Modak sa IdP 4 Ilagay ang IdP sa Modak 5 Buksan at subukan 6 Kailangan ang SSO 7 Pag-ugnay sa directory 8 Na-stuck ka ba?
1
Ginagawa ng admin ng workspaceTinatayang oras 20 min+

Bago magsimula

Ang pag-login gamit ang company account sa Modak ay itinatakda para sa bawat workspace. Ihanda muna ang apat na bagay sa ibaba.

Mga kailangan

  • Modak AI Plus na plano — ang pag-login gamit ang company account (SSO) at directory sync ay available simula sa Plus. Maaari itong i-enable sa Workspace Settings › Security·Audit. (Kasama rin ito sa plano ng Modak AI agent.)
  • Account ng admin ng Modak workspace — dapat mabuksan ang "Mga setting ng workspace" gamit ang gear sa kaliwang itaas.
  • Pahintulot bilang admin ng IdP ng kumpanya — sapat na ang anumang sumusuporta sa SAML 2.0 gaya ng Okta, Microsoft Entra ID, Google Workspace, OneLogin, o ADFS.
  • Taong may kakayahang baguhin ang DNS ng domain ng kumpanya — magdadagdag ng isang linya ng TXT record. (Hakbang ito para patunayang sa kumpanya ang domain.)
Ang ginamit mo sa SlackSa Modak,Saan
SAML SSOPag-login gamit ang company account (SAML)Settings ng workspace › Login·SSO › ②
Kailangan ang SSO (Require SSO)Kailangan ang SSO"Kailangan ang SSO" sa parehong screen
Mag-login direkta mula sa IdPMag-login agad mula sa IdP app tile"IdP app tile" sa parehong screen
Directory sync (SCIM)Directory sync (SCIM)Settings ng workspace › Login·SSO › ③
Tab na Login·SSO sa settings ng workspace — domain verification, pag-login gamit ang company account, at directory sync, tatlong seksyon
Settings ng workspace › tab na Login·SSO. Gawin ito mula itaas pababa (① → ② → ③) · I-click para lakihan
2
Modak + DNSTinatayang oras 5 min+

I-verify ang domain ng kumpanya

Ang mga makakapasok gamit ang company account ay yung may email mula sa verified domain lang. Ginagawa ito para pigilan ang mga taga-ibang kumpanya na mag-login bilang taga-atin, kaya kailangan itong gawin muna. Hindi maaaring i-verify ang mga public email tulad ng gmail.com o naver.com.

AIdagdag ang domain at kunin ang TXT value

  1. Sa kaliwang itaas ng Modak, i-click ang gear icon sa tabi ng pangalan ng workspace → buksan ang tab na Login·SSO.
  2. ① Pag-verify ng domain ng email ng kumpanya: ilagay ang domain ng kumpanya sa input box at pindutin ang "Magdagdag ng domain". (Halimbawa: example.co.kr — huwag isama ang email address o http://, domain lang)
  3. Lalabas sa ilalim ng domain ang host (pangalan) at TXT value. Pindutin ang "Kopyahin" sa bawat isa at itabi.
Screen na lumalabas ang host at TXT value kapag nagdagdag ng domain
Kapag nagdagdag ng domain, lalabas ang host at TXT value na ilalagay sa DNS · Pindutin para makita nang mas malaki

BMagdagdag ng TXT record sa DNS

  1. Buksan ang DNS management page ng domain ng kumpanya (Gabia, Route 53, Cloudflare, internal DNS, atbp.).
  2. Magdagdag ng TXT record. Sa host (pangalan), ilagay ang _modak-challenge, at sa value, ilagay nang eksakto ang modak-site-verification=… na ibinigay ng Modak.
  3. Pagkatapos i-save, bumalik sa Modak at pindutin ang 「Beripikahin」. Tapos na kapag naging 「Beripikado」 ang nasa tabi ng domain.
May DNS na awtomatikong nagdadagdag ng host — kung awtomatikong idinudugtong ng screen ang domain sa dulo, ilagay lang ang _modak-challenge. Kung kailangang ilagay ang buong pangalan, ilagay nang eksakto ang _modak-challenge.domain na ibinigay ng Modak. Maaaring abutin ng ilang minuto hanggang ilang oras bago maipakita ang DNS. Pwede nang burahin ang TXT record kapag na-verify na.

Magandang malaman

  • Isang workspace lang ang puwedeng mag-verify ng isang domain. Kung na-verify na ito sa ibang lugar, may lalabas na abiso — kung tama namang domain ito ng kumpanya, ipaalam sa support@modak.im.
  • Hanggang 10 domain lang ang puwedeng idagdag. Kung maraming kaanib na kumpanya ang gumagamit ng iisang workspace, beripikahin ang lahat ng domain.
3
Screen ng IdP adminTinatayang oras 10 min+

Iparehistro ang Modak sa IdP ng kumpanya

Gumawa ng isang SAML app sa IdP (Okta·Entra ID·Google atbp.) at ilagay ang mga value na ibibigay ng Modak. Makikita ang mga value sa Login·SSO › ② Login gamit ang account ng kumpanya (SAML) › 1 Hakbang ng Modak.

Hakbang 1 — Ang ACS URL at Entity ID na ilalagay sa IdP ng kumpanya para ma-register ang Modak
Mga value na ilalagay sa IdP. Pindutin ang "Kopyahin" sa tabi ng bawat value at i-paste · Pindutin para makita nang mas malaki
Mga value na ibibigay ng ModakPangalan sa IdP
ACS URLSingle sign-on URL · Reply URL(Assertion Consumer Service URL) · ACS URL
Entity IDAudience URI · SP Entity ID · Identifier
Format ng Name IDEmail address (EmailAddress) — gamitin ang email bilang username
Attributes (opsyonal)email · name — hindi kailangan kung email ang Name ID
Ang email ang pagkakakilanlan — kinikilala ng Modak ang tao gamit ang email ng kumpanya na ipinapadala ng IdP. Hindi makakapag-login kung hindi galing sa na-verify na domain ang email. Kung iba ang employee number o UPN sa email, palitan sa IdP ang Name ID (o email attribute) para maging email address.
Okta
  1. Pumunta sa Applications → Create App Integration at piliin ang SAML 2.0. Gawing Modak ang pangalan ng app.
  2. Ilagay ang ACS URL ng Modak sa Single sign-on URL at ang Entity ID sa Audience URI (SP Entity ID). Itakda ang Name ID format sa EmailAddress at ang Application username sa Email.
  3. (Opsyonal) Idagdag sa Attribute Statements ang email = user.email at name = user.displayName.
  4. Pagkatapos gawin ang app, kopyahin ang Metadata URL (o ang Identity Provider metadata link) sa tab na Sign On at itabi ito — gagamitin mo ito sa Hakbang 4.
  5. Sa Assignments, piliin ang mga tao o grupong gagamit ng Modak.
Microsoft Entra ID (Azure AD)
  1. Sa Enterprise applications → New application → Create your own application, piliin ang Integrate any other application you don't find in the gallery (Non-gallery) at gawin ito gamit ang pangalang Modak.
  2. Sa Single sign-on → SAML at Basic SAML Configuration, ilagay ang Entity ID ng Modak sa Identifier (Entity ID) at ang ACS URL sa Reply URL (ACS).
  3. Sa Attributes & Claims, itakda ang Unique User Identifier(Name ID) sa user.mail at ang format sa Email address. Kung iba ang UPN sa email, siguraduhing gawing mail.
  4. Kopyahin ang App Federation Metadata Url sa SAML Certificates at itabi — gagamitin mo ito sa Hakbang 4.
  5. Sa Users and groups, piliin ang mga taong gagamit ng Modak.
Google Workspace
  1. Pindutin ang sa admin console Apps → Web and Mobile Apps → Add App → Add Custom SAML App. Gawing Modak ang pangalan ng app.
  2. I-download ang XML file sa pamamagitan ng Download metadata sa screen na Google ID provider details at itabi ito — ia-upload mo ito sa Hakbang 4.
  3. Sa "Mga detalye ng service provider", ilagay ang ACS URL ng Modak sa ACS URL at ang Entity ID sa Audience URI (SP Entity ID). Itakda ang Name ID format sa EMAIL at ang Name ID sa Basic Information > Primary email.
  4. Sa app settings, palitan ang user access sa On (maaari mo itong itakda kada organizational unit).

Hindi sinusuportahan ng Google Workspace ang awtomatikong pag-provision ng user (SCIM) para sa sarili nitong ginawang SAML app — gamitin lang ang login (SSO), at mag-imbita ng tao o hayaang awtomatikong pumasok sa unang login nila.

Iba pang IdP (OneLogin · ADFS · Keycloak · Ping atbp.)
  1. Gumawa ng bagong SAML 2.0 app at ilagay ang ACS URL at Entity ID mula sa talahanayan sa itaas.
  2. Itakda ang Name ID bilang email address at ang pirma bilang Response o Assertion signature (RSA-SHA256).
  3. Kunin ang metadata URL o metadata XML file ng IdP at itabi.
  4. May mga IdP na awtomatikong pupunuin ang mga value sa itaas kung i-upload mo rito ang XML na nakuha mo sa 「I-download ang Modak (SP) metadata file」.
4
ModakTinatayang oras 3 min

Ilagay ang impormasyon ng IdP sa Modak

AIlagay ang metadata at i-verify

  1. Sa Modak, pumunta sa Login·SSO › ② › Hakbang 2 at i-paste ang metadata URL ng iyong IdP. Kung XML file ito, pindutin ang 「Mag-upload ng XML file」 para pumili ng file, o i-paste ang XML sa kahon sa ibaba.
  2. Pindutin ang "Suriin ang koneksyon". Kapag lumabas ang Entity ID, login address, at bilang at expiration date ng signing certificate ng IdP, tama ang pagkakabasa mo.
  3. Pindutin ang "I-save".
Kapag metadata URL ang inilagay, kukunin ulit ng Modak ang certificate isang beses kada araw (at kapag na-block ang login) kahit gumawa ng bagong certificate ang IdP. Kapag XML file ang inilagay, kailangan mong mag-upload ulit ng bagong file tuwing papalitan ang certificate.
Screen kung saan lumalabas ang Entity ID, login address, at signing certificate pagkatapos ilagay ang IdP metadata at pindutin ang suriin ang koneksyon
"Suriin ang koneksyon" — kapag nabasa nang tama ang IdP, lalabas ang Entity ID, login address, at certificate · Pindutin para makita nang mas malaki

BKapag iba ang pangalan ng email o name attribute (kadalasan nilalaktawan)

  1. Buksan ang "Palitan ang pangalan ng attribute".
  2. Kung ibang pangalan ang gamit ng IdP sa email maliban sa mail o emailaddress, isulat ang pangalan ng attribute na iyon. Kung iiwanang blangko, hahanapin ang email · mail · emailaddress · upn at Name ID (format ng email) nang sunud-sunod.
5
Modak + IdPTinatayang oras 5 min

I-on at subukan ang test login

AI-on

  1. Sa Hakbang 3 · Buksan at subukan, i-on ang 「Gamitin ang pag-login ng account ng kumpanya (SSO)」. Hindi ito mabubuksan kung walang domain verification at IdP metadata.
  2. Hindi mahaharangan ang dating login (email code·Google) dahil lang sa pag-on nito. Walang mapapalabas hangga't hindi pa tapos ang test.

BTest login

  1. Pindutin ang "Test login (bagong tab)". Magbubukas ang login page ng IdP ng kumpanya.
  2. Kapag nag-login ka gamit ang company account, bubukas ang Modak at makikita mo ang oras ng 「Huling tagumpay」 sa settings.
Huwag kalimutang italaga ang IdP app — dapat itong italaga sa tao sa IdP para gumana ang pag-login. Kailangan din ito ng admin mismo.
Screen kung saan i-on ang pag-login gamit ang company account at pindutin ang test login button
I-on ang "Gamitin" at pindutin ang "Test login" · Pindutin para makita nang mas malaki

CGanito papasok ang mga empleyado

  1. Sa login screen ng Modak, ilagay ang work email mo.
  2. Kapag may SSO ang domain na iyon, lalabas ang "Magpatuloy gamit ang account ng kumpanya" sa halip na email code. Kapag pinindot ito, dadaan sa login ng IdP at diretso kang papasok sa workspace.
  3. Puwede ring pumasok nang diretso sa pamamagitan ng pagpindot sa Modak sa listahan ng app (tile) ng IdP. (Kung ayaw mo nito, i-off ang "Payagan ang direktang login mula sa IdP app tile".)
Pareho rin sa desktop at mobile app — dahil sa browser nangyayari ang login sa app, papasok ka gamit ang account ng kumpanya gaya ng nasa itaas.
Login screen — kapag nag-type ng email, lalabas ang button na magpatuloy gamit ang account ng kumpanya
Kapag inilagay mo ang work email, lalabas ang 「Magpatuloy gamit ang company account」 · I-click para lakihan

Paano kung unang beses pumasok ang tao?

  • Kapag may unang pumasok gamit ang SSO na wala pa sa workspace, awtomatiko siyang idadagdag bilang miyembro. Makikita lang niya ang mga default channel, at ang role niya ay Member.
  • Kung ayaw mong awtomatikong idagdag, i-off ang 「Awtomatikong idagdag bilang miyembro ang unang pumasok」. Sa ganitong paraan, ang mga miyembro na at ang mga nagawa sa pamamagitan ng directory sync sa Hakbang 7 lang ang makakapasok.
6
OpsyonalPagkatapos lang ng test login

Gawing kailangan ang SSO

Kapag naka-on ang "Kailangan ang SSO", ang mga email sa beripikadong domain ay maaari lamang mag-login gamit ang account ng kumpanya. Mahaharangan ang login gamit ang email code, Google, at Works AI.

Kailangan ang SSO, IdP app tile, opsyon sa awtomatikong pagdagdag
Kapag nagtagumpay ang test login, maaari mo nang i-on ang「Kailangan ang SSO」 · I-click para lakihan
May proteksyon laban sa lockout — para hindi ma-lock out ang lahat dahil sa maling setting, maaari lang itong i-on pagkatapos magtagumpay ang test login. Kailangan ding mag-log in ulit gamit ang company account ng mga taong naka-log in na noong i-on ito. Exempt ang workspace admin, kaya kahit may problema sa IdP, makakapasok pa rin sila gamit ang email code at maaayos ang setting.

Magandang malaman

  • Hindi maaapektuhan ang mga email na hindi galing sa domain ng kumpanya (tulad ng guest ng external partner). Papasok pa rin sila gamit ang invite link at email code gaya ng dati.
  • Kapag na-off ang SSO o natanggal ang lahat ng beripikadong domain, mawawala rin ang "Kailangan ang SSO".
7
OpsyonalOkta · Entra ID atbp.

Awtomatikong pamamahala ng mga tao at team sa pamamagitan ng directory sync (SCIM)

Kapag na-on ang directory sync, awtomatikong magagawa sa Modak ang taong idinagdag sa IdP, at matatanggal din sa Modak ang taong na-deactivate dahil sa pag-alis o leave. Ang grupo sa IdP ay magiging team (user group) sa Modak, kaya puwede mong tawagin ang mga miyembro ng team gamit ang @pangalan-ng-team sa isang pindot lang.

AGumawa ng token sa Modak

  1. Sa Login·SSO › ③ Directory integration (SCIM), pindutin ang "Gumawa ng token". (Kailangang ma-verify na ang domain.)
  2. Lalabas ang SCIM Base URL at ang Secret Token. I-click ang bawat isa na 「Kopyahin」 at i-paste sa IdP. Ipapakita lang ang token nang isang beses.
Kung nawala ang token, pindutin ang "Gumawa ng bagong token". Agad mawawalan ng bisa ang lumang token, kaya ilagay ulit ang bagong token sa IdP. Kapag pinindot ang "Bawiin ang token", made-disable ang integration.
Seksyon ng directory sync — SCIM base URL at bagong gawang token
Ang SCIM base URL at token na ipe-paste sa IdP · Pindutin para makita nang mas malaki
Microsoft Entra ID
  1. Sa Provisioning → Get started ng enterprise app na ginawa mo sa Hakbang 3, itakda ang Provisioning Mode sa Automatic.
  2. Ilagay ang SCIM Base URL ng Modak sa Tenant URL at ang token sa Secret Token, pindutin ang Test Connection, at i-save kapag matagumpay.
  3. Sa Mappings → Provision Microsoft Entra ID Users (dating pangalan: Provision Azure Active Directory Users), itakda ang userName na mapunta sa mail (email ng kumpanya). Kapag ang default na userPrincipalName ay iba sa email, hindi makikilala ang parehong tao.
  4. Sa Users and groups, piliin ang mga tao o grupong ikokonekta at itakda ang Provisioning status sa On.
Okta
  1. Sa Okta, maghanda ng app na sumusuporta sa SCIM provisioning. Puwede kang gumamit ng app na tulad ng SCIM 2.0 Test App (Header Auth) sa catalog, kung saan direktang mailalagay ang SCIM base URL at token. (Maaaring walang Provisioning tab ang SAML app na ginawa mo mismo.)
  2. Sa Provisioning → Integration, ilagay ang SCIM Base URL ng Modak sa SCIM connector base URL, at userName sa Unique identifier field for users. Itakda ang Authentication Mode sa HTTP Header at ilagay ang token sa kahon ng Authorization.
  3. Kapag matagumpay ang Test Connector Configuration, i-save ito at i-on ang Create Users · Update User Attributes · Deactivate Users sa To App. Ipadala ang mga grupo gamit ang Push Groups.
Ginagawa sa IdPAno ang nangyayari sa Modak
Pagdagdag (Create) ng userKung ang email ay galing sa verified domain, awtomatiko siyang gagawing miyembro
Pagpapalit ng pangalan (Update) ng userPapalitan ang display name sa Modak (hindi mapapalitan ang email)
Pag-deactivate·pagbura (Deactivate) ng userMade-deactivate siya sa workspace. Mananatili ang mga post at file niya, at babalik siya kapag na-reactivate.
Gumawa, magdagdag, at magtanggal ng grupoGagawa ng mga team (grupo ng user) sa Modak at ilalagay ang mga miyembro

Magandang malaman

  • Hindi gagawa ng account ang email ng domain na hindi na-verify. Kahit malantad ang token, hindi makakapagdagdag ng tao mula sa ibang kumpanya.
  • Hindi natatanggal ang huling admin. Hindi binabago ang role (admin) sa pamamagitan ng SCIM — itinatakda ito sa loob ng Modak. Ang mga taong nagawa sa pamamagitan ng integration ay nagsisimula bilang miyembro.
  • Ang taong na-deactivate sa pamamagitan ng sync ay hindi na makakapasok gamit ang SSO. Babalik siya kapag na-reactivate sa IdP.
8
Pag-troubleshoot

Nahihirapan?

Mga karaniwang sitwasyon

Paulit-ulit na nabibigo ang "Beripikahin" ng domain
Tingnan kung ang host ng TXT record ay _modak-challenge (o _modak-challenge.domain) at kung ang value ay buo na modak-site-verification=…. Siguraduhin ding walang quotation mark o space sa harap at likod ng value. Maaaring tumagal bago maipakita ng DNS ang pagbabago.
Nakapag-login pero lumalabas ang "Ang email domain ng account ng kumpanya ay hindi beripikado sa workspace na ito"
Hindi beripikado sa Hakbang 2 ang domain ng email na ipinadala ng IdP. Kung domain ito ng kaanib na kumpanya, idagdag at beripikahin din ang domain na iyon. Kung UPN o employee number ang ipinapadala ng IdP imbes na email, tingnan ang setting ng Name ID/Email sa Hakbang 3.
Lumalabas ang "Hindi ka makapasok dahil walang email sa account ng kumpanya"
Walang email sa response ng IdP. Gawing EmailAddress ang Name ID format o magpadala ng email attribute. Kung iba ang pangalan ng attribute, isulat ito sa "Palitan ang pangalan ng attribute" sa Hakbang 4 B.
Hindi ma-on ang "Kailangan ang SSO" kahit sinusubukan
Kailangan munang magtagumpay ng isang test login bago ito ma-on. Unahin ang「Test login (bagong tab)」sa 5 Hakbang B.
Hindi makapag-login matapos palitan ang certificate ng IdP
Kung naglagay ka ng metadata bilang URL, awtomatikong kukuha ang Modak ng bagong certificate tuwing susubukan mong mag-login. Kung XML file ang inilagay mo, sa Hakbang 4 ay mag-upload ng bagong XML file at i-save ulit.
May error sa oras ng login
Mare-reject kung higit sa 3 minuto ang pagkakaiba ng oras ng IdP at Modak. Tingnan ang oras ng server ng IdP.
Hindi nagagawa ang mga tao sa pamamagitan ng sync
Tingnan ang dahilan ng error sa log ng IdP. Karaniwang dahilan ang ① hindi beripikado ang email domain ② may tao na may parehong email na (itakda ang userName match para unang hanapin ng IdP ang umiiral na tao) ③ na-revoke na ang token.