SharePoint-integraation määritys

Yleiskuva

Findable yhdistyy Microsoft SharePointiin Microsoft Graph API:n kautta. Kun yhteys on valmis, Findable voi seurata valittuja SharePoint-sivustoja, driveja tai kansioita ja peilata dokumentit Findableen luokittelua, hakua ja rakennettä varten.

Taustalla tapahtuu tämä:

• Findable tallentaa organisaatiolle yhden salatun Microsoft-tunnistejoukon.
• Findable luo subscriptionin jokaiselle SharePoint-sivustolle ja drivelle, joka kytketään rakennukseen.
• Kun tiedostoja lisätään tai muutetaan SharePointissa, Findable saa siitä automaattisen ilmoituksen.
• Dokumentit tuodaan Findableen, luokitellaan, tagitetaan ja tehdään haettäviksi.
• Jos vienti on päällä, Findable voi kirjoittaa käsiteltyjä dokumentteja ja metatietoja takaisin SharePointiin.

Findable noudattaa Microsoftin API-rajoja ja käsittelee muutokset tenant-kohtaisesti.

Tietoturva ja oikeudet

Findable tunnistautuu Microsoft Graph API:in Microsoft Entra ID:n App Registrationilla, aiemmin Azure AD. IT-tiiminne päättää tarkasti, mihin Findablella on pääsy.

Kaksi käyttöoikeustapaa

Tila	Oikeus	Mitä se tekee
Täysi pääsy	Sites.Read.All	Antaa lukuoikeuden kaikkiin SharePoint-sivustoihin tenantissa. Käytä Sites.ReadWrite.All, jos Findablen pitää myös kirjoittaa tiedostoja tai metatietoja takaisin SharePointiin.
Rajattu pääsy	Sites.Selected	Antaa pääsyn vain niihin SharePoint-sivustoihin, jotka hyväksytään erikseen. Sopii organisaatioille, jotka haluavat ohjata pääsyä sivustokohtaisesti.

Tunnistautuminen käyttää apprekisteroinnin client secretia. Secret salataan Findablessa ja sitä käytetään vain lyhytkestoisten access tokenien hakemiseen Microsoftilta.

Ohjattu määritys Findablessa

Avaa Asetukset → Integraatiot → SharePoint organisaation järjestelmänvalvojana. Opas luo pyynnöt sovelluksesi tunnuksen ja sivustojen osoitteiden perusteella ja tarkistaa Microsoft-käyttöoikeudet ennen rakennusten yhdistämistä.

Tarvitset myös Microsoft-järjestelmänvalvojan sovellusrekisteröintiä, järjestelmänvalvojan suostumusta ja sivustojen käyttöoikeuksia varten. Nämä ovat eri oikeuksia kuin Findablen järjestelmänvalvojan oikeudet. Valinnat ja sivustojen osoitteet tallennetaan selaimeen; salaisuuksia ja onnistuneita käyttöoikeustarkistuksia ei tallenneta sinne. Tarkista käyttöoikeudet uudelleen palatessasi.

1. Valitse käyttöoikeus

Valitse Valitut sivustot (suositeltu) käyttääksesi Sites.Selected-oikeutta. Valitse koko vuokraajan käyttöoikeus vain, jos organisaatiosi haluaa myöntää sen. Valitse vienti vain, jos Findablen pitää kirjoittaa asiakirjoja takaisin SharePointiin.

Valinta ei peruuta olemassa olevia koko vuokraajan Microsoft-käyttöoikeuksia. Jos opas havaitsee laajemmat oikeudet, järjestelmänvalvojan on poistettava ne ennen uutta tarkistusta.

2. Yhdistä Microsoft

1. Luo tai avaa Findablen sovellusrekisteröinti Microsoft Entra -hallintakeskuksessa.
2. Lisää kohdassa API permissions oikeus Microsoft Graph → Application permissions → Sites.Selected. Käytä koko vuokraajalle oikeutta Sites.Read.All tai vientiin oikeutta Sites.ReadWrite.All.
3. Myönnä organisaation järjestelmänvalvojan suostumus. Pelkkä käyttöoikeuden lisääminen ei riitä.
4. Luo asiakasohjelman salaisuus kohdassa Certificates & secrets. Kopioi Value, älä Secret ID -arvoa.
5. Anna vuokraajan tunnus, sovelluksen (asiakasohjelman) tunnus ja salaisuuden arvo Findablessa. Tallenna ja valitse Tarkista Microsoft-yhteys.

Onnistunut tarkistus vahvistaa tunnistetiedot ja sovelluksen käyttöoikeudet, mutta ei tietyn sivuston käyttöoikeutta.

3. Myönnä ja tarkista sivustojen käyttöoikeudet

Liitä sivuston osoite, esimerkiksi https://contoso.sharepoint.com/sites/Operations, https://contoso.sharepoint.com/teams/Facilities tai juurisivusto https://contoso.sharepoint.com. Käytä todellista osoitetta, säilytä URL-koodatut välilyönnit ja vältä kirjastojen ja tiedostojen linkkejä.

Jos käytössä on Sites.Selected, avaa Myönnä käyttöoikeus tälle sivustolle:

1. Avaa Microsoft Graph Explorer oikeassa vuokraajassa SharePoint-järjestelmänvalvojana tai ylemmällä roolilla. Avaa profiilivalikosta Consent to permissions ja hyväksy Graph Explorerin delegoitu Sites.FullControl.All. Vuokraajan käytäntö voi edellyttää toisen järjestelmänvalvojan hyväksyntää. Älä lisää tätä laajempaa oikeutta Findablen synkronointisovellukselle.
2. Valitse GET, kopioi Findablen luoma osoite ja suorita kysely Graph Explorerissa.
3. Liitä koko JSON-vastaus Findableen. Findable tarkistaa, että id ja webUrl kuuluvat sivustoon, ja luo käyttöoikeuden osoitteen ja pyynnön sisällön.
4. Valitse Graph Explorerissa POST, liitä luotu osoite ja sisältö ja suorita kysely. Rooli on tuonnille read tai write, jos vienti valittiin. Odota vastausta 201 Created.
5. Toista jokaiselle sivustolle ja valitse Findablessa Tarkista sivustojen käyttöoikeudet. Muutokset voivat kestää muutaman minuutin. Jos käyttöoikeus on jo olemassa, tarkista se ennen uuden myöntämistä.

Kopioi ohjeet IT-tuelle luo ohjeet ilman salaisuuksia. Kun vastaavan sivuston vastaus on liitetty, ohjeissa on myös luotu käyttöoikeuspyyntö.

Tarkistus lukee sivuston ja asiakirjakirjastot. Se ei kirjoita testitiedostoja eikä todista vientioikeutta. Puuttuva sivusto voi myös tarkoittaa, että Microsoft piilottaa sen puuttuvan käyttöoikeuden vuoksi. Opas erottaa tämän estetystä käytöstä ja tilapäisistä virheistä.

Katso Microsoftin valittujen käyttöoikeuksien yleiskatsaus ja sivustokäyttöoikeuksien API.

4. Yhdistä rakennukset ja aloita synkronointi

Valitse Valitse rakennus, avaa rakennus luettelosta ja lisää SharePoint-tilaus. Anna hyväksytty sivusto-osoite, valitse asiakirjakirjasto sekä koko kirjasto tai valitut kansiot ja tarkista ja luo tilaus. Ensimmäinen synkronointi alkaa automaattisesti, ja rakennuspaneeli näyttää edistymisen.

Kansioiden valinta rajoittaa Findablen tuontia. Microsoft-käyttöoikeus koskee silti koko hyväksyttyä sivustoa.

5. Valinnainen vienti

Varmista sivuston write-oikeus Microsoft-järjestelmänvalvojalta ennen viennin käyttöönottoa. Ota vienti käyttöön rakennuksen SharePoint-asetuksissa, valitse kohdesivusto, kirjasto ja kansio ja käytä toimintoa Vie SharePointiin. Vienti valitaan erikseen kullekin rakennukselle.

---

Tarvitsetko apua?

Jos määritys pysähtyy, ota yhteys osoitteeseen support@findable.ai tai käytä Findablen oikean alakulman chatia.