Indexera ditt Dropbox-innehåll med Dropbox-anslutningen för Amazon Kendra

Amazon Kendra är en mycket exakt och lättanvänd intelligent söktjänst som drivs av maskininlärning (ML). Amazon Kendra erbjuder en svit av datakälla-anslutningar för att förenkla processen att ta in och indexera ditt innehåll, var det än finns.

Värdefull data i organisationer lagras i både strukturerade och ostrukturerade arkiv. En företagssökningslösning bör kunna dra ihop data över flera strukturerade och ostrukturerade arkiv att indexera och söka på.

Ett sådant datalager är Dropbox. Företagsanvändare använder Dropbox för att ladda upp, överföra och lagra dokument till molnet. Tillsammans med möjligheten att lagra dokument erbjuder Dropbox Dropbox Paper, ett samredigeringsverktyg som låter användare samarbeta och skapa innehåll på ett ställe. Dropbox Paper kan valfritt använda mallar för att lägga till struktur till dokument. Förutom filer och papper låter Dropbox dig också lagra genvägar till webbsidor i dina mappar.

Vi är glada att kunna meddela att du nu kan använda Amazon Kendra-anslutningen för Dropbox för att söka efter information som lagras i ditt Dropbox-konto. I det här inlägget visar vi hur man indexerar information lagrad i Dropbox och använder Amazon Kendras intelligenta sökfunktion. Dessutom kan Amazon Kendras ML-drivna intelligenta sökning exakt hitta information från ostrukturerade dokument med naturligt språkberättande innehåll, för vilket nyckelordssökning inte är särskilt effektivt.

Lösningsöversikt

Med Amazon Kendra kan du konfigurera flera datakällor för att ge en central plats att söka i ditt dokumentarkiv. För vår lösning visar vi hur man indexerar ett Dropbox-förråd eller -mapp med hjälp av Amazon Kendra-anslutningen för Dropbox. Lösningen består av följande steg:

1. Konfigurera en app på Dropbox och få anslutningsinformationen.
2. Spara detaljerna i AWS Secrets Manager.
3. Skapa en Dropbox-datakälla via Amazon Kendra-konsolen.
4. Indexera data i Dropbox-förvaret.
5. Kör en exempelfråga för att få informationen.

Förutsättningar

För att prova Amazon Kendra-kontakten för Dropbox behöver du följande:

Konfigurera en Dropbox-app och samla in anslutningsdetaljer

Innan vi ställer in Dropbox-datakällan behöver vi några detaljer om ditt Dropbox-förråd. Låt oss samla dem i förväg.

1. Gå till www.dropbox.com/developers.
2. Välja Appkonsol.
   
3. Logga in med dina referenser (se till att du loggar in på ett Enterprise-konto).
   
4. Välja Skapa app.
   
5. Välja Avgränsad åtkomst.
6. Välja Fullständig Dropbox (eller namnet på den specifika mapp du vill indexera).
7. Ange ett namn för din app.
8. Välja Skapa app.
   
   Du kan se konfigurationsskärmen med en uppsättning flikar.
9. För att ställa in behörigheter, välj behörigheter fliken.
   
10. Välj en minimal uppsättning behörigheter, som visas i följande skärmdumpar.
    
11. Välja Skicka.
    
    Ett meddelande visas som säger att behörighetsändringen lyckades.
    
12. På Inställningar kopiera appnyckeln.
13. Välja Show bredvid App hemlig och kopiera hemligheten.
14. Enligt Genererad åtkomsttokenväljer Generera och kopiera token.
    

Förvara dessa värden på ett säkert ställe – vi måste hänvisa till dem senare.

Sessionstoken är giltig i upp till 4 timmar. Du måste generera en ny sessionstoken varje gång du indexerar innehållet.

Lagra Dropbox-uppgifter i Secrets Manager

För att lagra dina Dropbox-uppgifter i Secrets Manager, tävla i följande steg:

1. Välj på Secrets Manager-konsolen Lagra en ny hemlighet.
2. Välja Annan typ av hemlighet.
3. Skapa tre nyckel-värdepar för appKey, appSecretoch refreshToken och ange värdena som sparats från Dropbox.
4. Välja Save.
   
5. För Hemligt namn, ange ett namn (t.ex. AmazonKendra-dropbox-secret).
6. Ange en valfri beskrivning.
7. Välja Nästa.
   
8. I Konfigurera rotation sektionen, behåll alla inställningar på sina standardinställningar och välj Nästa.
   
9. På översyn sida, välj HITTA BUTIK.
   

Konfigurera Amazon Kendra-kontakten för Dropbox

Utför följande steg för att konfigurera Amazon Kendra-kontakten:

1. Välj på Amazon Kendra-konsolen Skapa ett index.
   
2. För Indexnamnanger du ett namn för indexet (t.ex. my-dropbox-index).
3. Ange en valfri beskrivning.
4. För Rollnamn, ange ett IAM-rollnamn.
5. Konfigurera valfria krypteringsinställningar och taggar.
6. Välja Nästa.
   
7. I Konfigurera användaråtkomstkontroll lämna inställningarna på sina standardinställningar och välj Nästa.
   
8. För Tillhandahålla utgåvor, Välj Utvecklarutgåva.
9. Välja Skapa.
   
   Detta skapar och sprider IAM-rollen och skapar sedan Amazon Kendra-index, vilket kan ta upp till 30 minuter.
10. Välja Datakällor i navigeringsfönstret.
    
11. Enligt dropboxväljer Lägg till kontakt.
    
12. För Datakällans namn, ange ett namn (t.ex. my-dropbox-connector).
13. Ange en valfri beskrivning.
14. Välja Nästa.
    
15. För Typ av autentiseringstoken, Välj Åtkomsttoken (tillfällig användning).
16. För AWS Secrets Manager hemlighet, välj hemligheten du skapade tidigare.
17. För IAM-rollväljer Skapa en ny roll.
18. För Rollnamn, ange ett namn (t.ex. AmazonKendra-dropbox-role).
19. Välja Nästa.
    
20. För Välj enheter eller innehållstyper, välj dina innehållstyper.
21. För Frekvensväljer Kör på begäran.
22. Välja Nästa.
    
23. Ställ in valfria fältmappningar och välj Nästa.
24. Välja Granska och skapa Och välj Lägg till datakälla.
25. Välja Synkronisera nu.
    
26. Vänta tills synkroniseringen är klar.
    

Testa lösningen

Nu när du har fått in innehållet från ditt Dropbox-konto till ditt Amazon Kendra-index kan du testa några frågor.

Gå till ditt index och välj Sök efter indexerat innehåll. Ange ett exempel på en sökfråga och testa dina sökresultat (din fråga kommer att variera beroende på innehållet i ditt konto).

Dropbox-anslutningen genomsöker också lokal identitetsinformation från Dropbox. För användare anger den användarens e-post-id som huvudansvarig. För grupper anger den grupp-id som huvudman. För att filtrera sökresultat efter användare/grupper, gå till Search Console.

Klicka på "Testfråga med användarnamn eller grupper" för att expandera den och klicka på knappen som säger "tillämpa användarnamn eller grupper".

Ange användar- och/eller gruppnamn och klicka Ansök. Skriv sedan in sökfrågan och tryck på Retur. Detta ger dig en filtrerad uppsättning resultat baserat på dina kriterier.

Grattis! Du har framgångsrikt använt Amazon Kendra för att få fram svar och insikter baserat på innehållet som indexerats från ditt Dropbox-konto.

Generera permanenta tokens för offlineåtkomst

Instruktionerna i det här inlägget leder dig genom att skapa, konfigurera och använda en tillfällig åtkomsttoken. Appar kan också få långtidsåtkomst genom att begära offlineåtkomst, i vilket fall appen får en uppdateringstoken som kan användas för att hämta nya kortlivade åtkomsttokens efter behov, utan ytterligare manuellt användaringripande. Du kan hitta mer information i Dropbox OAuth-guide och Dokumentation för Dropbox-auktorisering. Använd följande steg för att skapa en permanent uppdateringstoken (till exempel för att ställa in synkroniseringen att utlösas enligt ett schema):

1. Få appnyckeln och apphemligheten som tidigare.
2. I en ny webbläsare, navigera till https://www.dropbox.com/oauth2/authorize?token_access_type=offline&response_type=code&client_id=.
3. Acceptera standardinställningarna och välj Skicka.
4. Välja Fortsätta.
   
5. Välja Tillåt.
   
   En åtkomstkod genereras åt dig.
6. Kopiera åtkomstkoden.
   
   Nu får du uppdateringstoken från åtkomstkoden.
7. Kör följande curl-kommando i ett terminalfönster:

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

   

Du kan lagra denna uppdateringstoken tillsammans med appnyckeln och apphemligheten för att konfigurera en permanent token i datakällans konfiguration för Amazon Kendra. Amazon Kendra genererar åtkomsttoken och använder den efter behov för åtkomst.

Begränsningar

Denna lösning har följande begränsningar:

• Filkommentarer importeras inte till indexet
• Du har inte möjlighet att lägga till anpassad metadata för Dropbox
• Google-dokument, -ark och -bilder behöver en Google-arbetsyta eller ett Google-konto och ingår inte

Slutsats

Med Dropbox-anslutningen för Amazon Kendra kan organisationer utnyttja arkivet med information som lagras på deras konto på ett säkert sätt med hjälp av intelligent sökning som drivs av Amazon Kendra.

I det här inlägget introducerade vi dig till grunderna, men det finns många ytterligare funktioner som vi inte täckte. Till exempel:

• Du kan aktivera användarbaserad åtkomstkontroll för ditt Amazon Kendra-index och begränsa åtkomsten till användare och grupper som du konfigurerar
• Du kan ange allowedUsersColumn och allowedGroupsColumn så att du kan tillämpa åtkomstkontroller baserat på användare respektive grupper
• Du kan mappa ytterligare fält till Amazon Kendra-indexattribut och aktivera dem för facettering, sökning och visning i sökresultaten
• Du kan integrera Dropbox-datakällan med CDE-kapaciteten (Custom Document Enrichment) i Amazon Kendra för att utföra ytterligare attributmappningslogik och till och med anpassat innehållstransformation under inmatning

För att lära dig mer om dessa möjligheter och mer, se Amazon Kendra utvecklarguide.

---

Om författaren

Ashish Lagwankar är Senior Enterprise Solutions Architect på AWS. Hans kärnintressen inkluderar AI/ML, serverlös och containerteknologi. Ashish är baserad i Boston, MA, området och tycker om att läsa, utomhus och umgås med sin familj.