Indekser dit Dropbox-indhold ved hjælp af Dropbox-stikket til Amazon Kendra

Amazon Kendra er en meget nøjagtig og brugervenlig intelligent søgetjeneste drevet af maskinlæring (ML). Amazon Kendra tilbyder en række datakildeforbindelser til at forenkle processen med at indtage og indeksere dit indhold, uanset hvor det befinder sig.

Værdifulde data i organisationer lagres i både strukturerede og ustrukturerede depoter. En virksomhedssøgningsløsning bør være i stand til at samle data på tværs af flere strukturerede og ustrukturerede repositories til at indeksere og søge på.

Et sådant datalager er Dropbox. Enterprise-brugere bruger Dropbox til at uploade, overføre og gemme dokumenter til skyen. Sammen med muligheden for at gemme dokumenter tilbyder Dropbox Dropbox Paper, et samredigeringsværktøj, der lader brugere samarbejde og skabe indhold ét sted. Dropbox Paper kan valgfrit bruge skabeloner til at tilføje struktur til dokumenter. Ud over filer og papir giver Dropbox dig også mulighed for at gemme genveje til websider i dine mapper.

Vi er glade for at kunne meddele, at du nu kan bruge Amazon Kendra-stikket til Dropbox til at søge efter oplysninger, der er gemt på din Dropbox-konto. I dette indlæg viser vi, hvordan man indekserer oplysninger gemt i Dropbox og bruger Amazon Kendra intelligente søgefunktion. Derudover kan Amazon Kendras ML-drevne intelligente søgning nøjagtigt finde information fra ustrukturerede dokumenter med et naturligt sprogfortællende indhold, hvor søgeordssøgning ikke er særlig effektiv.

Løsningsoversigt

Med Amazon Kendra kan du konfigurere flere datakilder for at give et centralt sted at søge på tværs af dit dokumentlager. Til vores løsning demonstrerer vi, hvordan man indekserer et Dropbox-lager eller en mappe ved hjælp af Amazon Kendra-stikket til Dropbox. Løsningen består af følgende trin:

1. Konfigurer en app på Dropbox og få forbindelsesdetaljerne.
2. Gem detaljerne i AWS Secrets Manager.
3. Opret en Dropbox-datakilde via Amazon Kendra-konsollen.
4. Indekser dataene i Dropbox-lageret.
5. Kør en prøveforespørgsel for at få oplysningerne.

Forudsætninger

For at prøve Amazon Kendra-stikket til Dropbox skal du bruge følgende:

Konfigurer en Dropbox-app, og indhent forbindelsesdetaljer

Før vi konfigurerer Dropbox-datakilden, har vi brug for et par detaljer om dit Dropbox-lager. Lad os samle dem på forhånd.

1. Gå til www.dropbox.com/developers.
2. Vælg App konsol.
   
3. Log ind med dine legitimationsoplysninger (sørg for, at du logger ind på en Enterprise-konto).
   
4. Vælg Opret app.
   
5. Type Omfanget adgang.
6. Type Fuld Dropbox (eller navnet på den specifikke mappe, du vil indeksere).
7. Indtast et navn til din app.
8. Vælg Opret app.
   
   Du kan se konfigurationsskærmen med et sæt faner.
9. For at konfigurere tilladelser skal du vælge Tilladelser fane.
   
10. Vælg et minimalt sæt tilladelser, som vist på de følgende skærmbilleder.
    
11. Vælg Indsend.
    
    Der vises en meddelelse om, at tilladelsesændringen lykkedes.
    
12. På Indstillinger fanen, skal du kopiere app-nøglen.
13. Vælg show siden App hemmelig og kopiere hemmeligheden.
14. Under Genereret adgangstoken, vælg Generer og kopier tokenet.
    

Opbevar disse værdier på et sikkert sted – vi skal henvise til dem senere.

Sessionstokenet er gyldigt i op til 4 timer. Du skal generere et nyt sessionstoken, hver gang du indekserer indholdet.

Gem Dropbox-legitimationsoplysninger i Secrets Manager

For at gemme dine Dropbox-legitimationsoplysninger i Secrets Manager skal du konkurrere på følgende trin:

1. På Secrets Manager-konsollen skal du vælge Gem en ny hemmelighed.
2. Vælg Anden type hemmelighed.
3. Opret tre nøgleværdi-par for appKey, appSecretog refreshToken og indtast de værdier, der er gemt fra Dropbox.
4. Vælg Gem.
   
5. Til Hemmeligt navn, indtast et navn (f.eks. AmazonKendra-dropbox-secret).
6. Indtast en valgfri beskrivelse.
7. Vælg Næste.
   
8. I Konfigurer rotation sektion, behold alle indstillinger på deres standardindstillinger og vælg Næste.
   
9. På anmeldelse side, vælg Butik.
   

Konfigurer Amazon Kendra-stikket til Dropbox

For at konfigurere Amazon Kendra-stikket skal du udføre følgende trin:

1. Vælg på Amazon Kendra-konsollen Opret et indeks.
   
2. Til Indeksnavn, indtast et navn til indekset (f.eks. my-dropbox-index).
3. Indtast en valgfri beskrivelse.
4. Til Rollenavn, indtast et IAM-rollenavn.
5. Konfigurer valgfri krypteringsindstillinger og tags.
6. Vælg Næste.
   
7. I Konfigurer brugeradgangskontrol sektion, lad indstillingerne være på deres standardindstillinger og vælg Næste.
   
8. Til Provisioning udgaver, Vælg Developer udgave.
9. Vælg Opret.
   
   Dette opretter og udbreder IAM-rollen og opretter derefter Amazon Kendra-indekset, som kan tage op til 30 minutter.
10. Vælg Data kilder i navigationsruden.
    
11. Under Dropbox, vælg Tilføj stik.
    
12. Til Datakildenavn, indtast et navn (f.eks. my-dropbox-connector).
13. Indtast en valgfri beskrivelse.
14. Vælg Næste.
    
15. Til Type godkendelsestoken, Vælg Adgangstoken (midlertidig brug).
16. Til AWS Secrets Manager-hemmelighed, vælg den hemmelighed, du oprettede tidligere.
17. Til IAM rolle, vælg Lav en ny rolle.
18. Til Rollenavn, indtast et navn (f.eks. AmazonKendra-dropbox-role).
19. Vælg Næste.
    
20. Til Vælg enheder eller indholdstyper, vælg dine indholdstyper.
21. Til Frekvens, vælg Kør efter behov.
22. Vælg Næste.
    
23. Indstil eventuelle valgfrie felttilknytninger og vælg Næste.
24. Vælg Gennemgå og opret Og vælg Tilføj datakilde.
25. Vælg Synkroniser nu.
    
26. Vent på, at synkroniseringen er fuldført.
    

Test løsningen

Nu hvor du har indtaget indholdet fra din Dropbox-konto i dit Amazon Kendra-indeks, kan du teste nogle forespørgsler.

Gå til dit indeks og vælg Søg efter indekseret indhold. Indtast et eksempel på en søgeforespørgsel, og test dine søgeresultater (din forespørgsel vil variere baseret på indholdet af din konto).

Dropbox-forbindelsen gennemgår også lokale identitetsoplysninger fra Dropbox. For brugere angiver den brugerens e-mail-id som principal. For grupper sætter den gruppe-id som hovedstol. For at filtrere søgeresultater efter brugere/grupper skal du gå til Search Console.

Klik på "Testforespørgsel med brugernavn eller grupper" for at udvide den og klik på knappen, der siger "anvende brugernavn eller grupper".

Indtast bruger- og/eller gruppenavne, og klik Indløs. Indtast derefter søgeforespørgslen og tryk enter. Dette giver dig et filtreret sæt resultater baseret på dine kriterier.

Tillykke! Du har med succes brugt Amazon Kendra til at få svar og indsigt baseret på indholdet indekseret fra din Dropbox-konto.

Generer permanente tokens til offlineadgang

Instruktionerne i dette indlæg leder dig gennem oprettelse, konfiguration og brug af et midlertidigt adgangstoken. Apps kan også få langtidsadgang ved at anmode om offlineadgang, i hvilket tilfælde appen modtager et opdateringstoken, der kan bruges til at hente nye kortlivede adgangstokens efter behov, uden yderligere manuel brugerintervention. Du kan finde mere information i Dropbox OAuth-vejledning , Dropbox-godkendelsesdokumentation. Brug følgende trin til at oprette et permanent opdateringstoken (for eksempel for at indstille synkroniseringen til at udløse efter en tidsplan):

1. Få appnøglen og apphemmeligheden som før.
2. I en ny browser skal du navigere til https://www.dropbox.com/oauth2/authorize?token_access_type=offline&response_type=code&client_id=.
3. Accepter standardindstillingerne og vælg Indsend.
4. Vælg Fortsæt..
   
5. Vælg Tillad.
   
   Der genereres en adgangskode til dig.
6. Kopiér adgangskoden.
   
   Nu får du opdateringstokenet fra adgangskoden.
7. Kør følgende curl-kommando i et terminalvindue:

   curl https://api.dropbox.com/oauth2/token -d code= -d grant_type=authorization_code -u :

   

Du kan gemme dette opdateringstoken sammen med appnøglen og apphemmeligheden for at konfigurere et permanent token i datakildekonfigurationen for Amazon Kendra. Amazon Kendra genererer adgangstokenet og bruger det efter behov for adgang.

Begrænsninger

Denne løsning har følgende begrænsninger:

• Filkommentarer importeres ikke til indekset
• Du har ikke mulighed for at tilføje brugerdefinerede metadata til Dropbox
• Google-dokumenter, -ark og -dias skal have et Google-arbejdsområde eller en Google-konto og er ikke inkluderet

Konklusion

Med Dropbox-stikket til Amazon Kendra kan organisationer udnytte lageret af oplysninger, der er gemt på deres konto, sikkert ved hjælp af intelligent søgning drevet af Amazon Kendra.

I dette indlæg introducerede vi dig til det grundlæggende, men der er mange ekstra funktioner, som vi ikke dækkede. For eksempel:

• Du kan aktivere brugerbaseret adgangskontrol til dit Amazon Kendra-indeks og begrænse adgangen til brugere og grupper, som du konfigurerer
• Du kan angive allowedUsersColumn , allowedGroupsColumn så du kan anvende adgangskontrol baseret på henholdsvis brugere og grupper
• Du kan tilknytte yderligere felter til Amazon Kendra-indeksattributter og aktivere dem til facettering, søgning og visning i søgeresultaterne
• Du kan integrere Dropbox-datakilden med Custom Document Enrichment-funktionen (CDE) i Amazon Kendra for at udføre yderligere attributkortlægningslogik og endda tilpasset indholdstransformation under indtagelse

For at lære om disse muligheder og mere, se Amazon Kendra Developer Guide.

---

Om forfatteren

Ashish Lagwankar er Senior Enterprise Solutions Architect hos AWS. Hans kerneinteresser omfatter AI/ML, serverløse og containerteknologier. Ashish er baseret i Boston, MA-området og nyder at læse, udendørs og tilbringe tid med sin familie.