Provisioi käyttäjät ja ryhmät SCIMin avulla

Notionin SCIM API mahdollistaa seuraavat toiminnot:

• Luo ja poista jäseniä työtilastasi.

• Päivitä jäsenen profiilitiedot.

• Hae työtilasi jäsenet.

• Etsi jäseniä sähköpostiosoitteen tai nimen perusteella.

• Luo ja poista ryhmiä työtilastasi.

• Lisää ja poista ryhmän jäseniä.

• Hae työtilasi ryhmät.

• Etsi ryhmiä nimen perusteella.

Tuemme tällä hetkellä Oktaa, OneLoginia, Ripplingiä ja mukautettuja SCIM-sovelluksia. Jos käytät muuta identiteetinhallintapalvelua, kerro siitä meille. Katso ohjeet identiteetinhallintapalvelun määrittämiseen tietyille sovelluksille täältä →

SCIMin käyttäminen Notionissa edellyttää:

• Työtilallasi on oltava Enterprise-sopimus.

• Identiteetinhallintapalvelusi (IdP) tulee tukea SAML 2.0 -protokollaa. Katso ohjeet identiteetinhallintapalvelun määrittämiseen tietyille sovelluksille täältä →

• Työtilasi omistajan täytyy määrittää SCIM Notion-työtilassa.

• Sinun on vahvistettava sähköpostiverkkotunnuksen omistajuus, jos haluat käyttää SCIM-palvelua käyttäjän nimen tai sähköpostiosoitteen muokkaamiseen. Lue lisää verkkotunnuksen vahvistamisesta →

Vain Enterprise-sopimuksen organisaation omistajat voivat luoda ja tarkastella SCIM API -tunnuksia. SCIM API -tunnuksen luominen:

1. Avaa työtilan vaihtaja ja valitse Hallitse organisaatiota. Sinun on ehkä ensin Määritä organisaatio, jos et ole vielä tehnyt niin. Lue lisää täältä →

2. Valitse organisaatiotason hallintatyökalujen Yleiset-välilehdellä > kohdan SCIM-provisiointi vierestä.

Kun työtilan omistaja poistuu työtilasta tai hänen roolinsa muuttuu, hänen tunnuksensa peruutetaan. Kun näin tapahtuu, jäljellä oleville työtilan omistajille lähetetään automaattinen viesti, jossa heitä pyydetään korvaamaan peruutettu tunnus.

Lisäksi työtilan omistajat voivat peruuttaa aktiivisia tunnuksia työtilassa. Peruuta tunnus napsauttamalla 🗑-kuvaketta kyseisen tunnuksen kohdalla.

Jos tunnus peruutetaan, se on korvattava kaikissa olemassa olevissa integraatioissa.

Kaikki SCIM-integraatiot ja käyttäjien provisiointi, jotka perustuvat kumottuun tunnukseen, poistetaan käytöstä, kunnes ne korvataan aktiivisella tunnuksella.

Enterprise-sopimuksen organisaation omistajat voivat hallita, saavatko käyttäjät kutsut työtiloihin ja ryhmiin sähköpostitse, kun heidät provisioidaan SCIMin avulla, seuraavasti:

1. Avaa työtilan valitsin ja valitse Hallitse organisaatiota.

2. Yleiset-välilehdellä ota käyttöön Estä SCIM-provisioinnin kutsusähköpostit, jos et halua lähettää sähköposteja käyttäjille.

Jos haluat ottaa käyttöön rajoitetun jäsenen SCIMin avulla, sinun on asetettava SCIMin 'role'-attribuuttiksi 'restricted_member':

\"urn:ietf:params:scim:schemas:extension:notion:2.0:User\": { role: string // \"owner\" | \"membership_admin\" | \"member\" | \"restricted_member\" }

Jos haluat muuntaa sivuvieraan rajoitetuksi jäseneksi SCIM:n kautta, sinun on käytettävä POST /scim/v2/Users.

• GET /ServiceProviderConfig

  • GET

  • Nouda kuvaus käytettävissä olevista SCIM-määritysominaisuuksista.

  • Määritetty SCIM-protokollamäärityksen kohdassa 5.

• GET /ResourceTypes

  • GET

  • Hae luettelo käytettävissä olevista SCIM-resurssityypeistä.

  • Määritetty SCIM-protokollamäärityksen kohdassa 6.

Alla olevassa taulukossa esitetään SCIM-käyttäjäattribuuttien ja Notion-käyttäjäprofiilikenttien välinen vastaavuus. Organisaation omistajat valitsevat, mitä attribuutteja Notionille lähetetään, ja voivat päivittää niitä milloin tahansa. Notion käsittelee Notion SCIM API:n kautta lähettämiäsi attribuutteja parantaakseen käyttäjien ja ryhmien hallintaa ja provisiointia.

• GET /Users

  • GET

  • Hae sivutettu luettelo työtilan jäsenistä.

  • Voit sivuttaa käyttämällä startIndex- ja count-parametreja. Huomaa, että startIndex on 1-indeksoitu ja count-parametrin enimmäisarvo on 100.

  • Voit suodattaa tuloksia filter-parametrilla. Kelvollisia suodatusmääritteitä ovat email, given_name ja family_name, esim. GET

  • Huomaa, että given_name ja family_name ovat kirjainkoosta riippuvaisia. Sähköpostiosoite muutetaan pieniksi kirjaimiksi.

• GET /Users/

  • GET

  • Hae tietty työtilan jäsen Notion-käyttäjätunnuksella. Tämä on 32-merkkinen UUID seuraavassa muodossa: 00000000-0000-0000-0000-000000000000.

  • Huomaa, että meta.created ja meta.lastModified eivät vastaa merkityksellisiä aikaleima-arvoja.

• POST /Users

  • POST

  • Jos lisäämälläsi käyttäjällä on jo Notion-käyttäjätili samalla sähköpostiosoitteella, hänet lisätään työtilaasi.

  • Jos käyttäjää ei ole olemassa, tämän kutsuminen luo uuden Notion-käyttäjän ja lisää kyseisen käyttäjän työtilaan. Hänet yhdistetään luotavaan Notion-käyttäjäprofiiliin.

  • SCIM-rajapinta lukee profiilikuvaominaisuuden käyttäjän luonnin yhteydessä, mutta ei päivitysten yhteydessä.

• PATCH /Users/

  • PATCH

  • Päivitä sarjalla operaatioita ja palauta päivitetty käyttäjätietue.

• PUT /Users/

  • PUT

  • Päivitä ja palauta päivitetty käyttäjätietue.

• DELETE /Users/

  • DELETE

  • Poista käyttäjä työtilastasi. Käyttäjä kirjataan ulos kaikista aktiivisista istunnoista.

    • Käyttäjätiliä ei voi poistaa SCIMin kautta. Tilin poistaminen on tehtävä manuaalisesti.

    • Käyttäjän poistaminen työtilasta voidaan saavuttaa myös asettamalla active-käyttäjämäärite arvoon false lähettämällä PATCH /Users/- tai PUT /Users/-pyyntö.

    • SCIM-bottitunnisteen luonutta työtilan omistajaa ei voi poistaa API:n kautta. Kun työtilan omistaja poistetaan SCIM API:n kautta, kaikki hänen luomansa tunnisteet mitätöidään ja kaikki kyseistä bottia käyttävät integraatiot lakkaavat toimimasta.

• GET /Groups

  • GET

  • Hae sivutettu luettelo työtilaryhmistä.

  • Voit sivuttaa tulokset käyttämällä startIndex- ja count-parametreja. Huomaa, että startIndex on 1-indeksoitu ja count-parametrin enimmäisarvo on 100, esim. GET

    • Jos sivutusta ei käytetä, pyynnössä palautetaan enintään 100 työtilaryhmää.

  • Voit suodattaa tuloksia filter-parametrilla. Ryhmiä voi suodattaa niiden displayName-määritteen perusteella, esim. GET

• GET /Groups/

  • GET

  • Hae tietty työtilaryhmä Notion-ryhmätunnuksen perusteella. Tämä on 32-merkkinen UUID seuraavassa muodossa: 00000000-0000-0000-0000-000000000000.

• POST /Groups

  • POST

  • Luo uusi työtilaryhmä.

• PATCH /Groups/

  • PATCH

  • Päivitä työtilaryhmää sarjan operaatioiden avulla.

• PUT /Groups/

  • PUT

  • Päivitä työtilaryhmä.

• DELETE /Groups/

  • DELETE

  • Poista työtilaryhmä.