Indexeer uw Dropbox-inhoud met behulp van de Dropbox-connector voor Amazon Kendra

Amazon Kendra is een zeer nauwkeurige en gebruiksvriendelijke intelligente zoekservice die wordt aangedreven door machine learning (ML). Amazon Kendra biedt een reeks gegevensbronconnectoren om het proces van het opnemen en indexeren van uw inhoud te vereenvoudigen, waar deze zich ook bevindt.

Waardevolle data in organisaties wordt opgeslagen in zowel gestructureerde als ongestructureerde repositories. Een enterprise search-oplossing moet in staat zijn om gegevens uit verschillende gestructureerde en ongestructureerde repositories samen te brengen om te indexeren en te doorzoeken.

Een van die gegevensopslagplaatsen is Dropbox. Enterprise-gebruikers gebruiken Dropbox om documenten naar de cloud te uploaden, over te dragen en op te slaan. Naast de mogelijkheid om documenten op te slaan, biedt Dropbox Dropbox Paper, een tool voor co-editing waarmee gebruikers kunnen samenwerken en inhoud kunnen maken op één plek. Dropbox Paper kan optioneel sjablonen gebruiken om structuur aan documenten toe te voegen. Naast bestanden en papier kun je met Dropbox ook snelkoppelingen naar webpagina's in je mappen opslaan.

We zijn verheugd om aan te kondigen dat je nu de Amazon Kendra-connector voor Dropbox kunt gebruiken om informatie te zoeken die is opgeslagen in je Dropbox-account. In dit bericht laten we zien hoe u informatie kunt indexeren die is opgeslagen in Dropbox en hoe u de intelligente zoekfunctie van Amazon Kendra kunt gebruiken. Bovendien kan de door ML aangedreven intelligente zoekfunctie van Amazon Kendra nauwkeurig informatie vinden uit ongestructureerde documenten met verhalende inhoud in natuurlijke taal, waarvoor het zoeken op trefwoorden niet erg effectief is.

Overzicht oplossingen

Met Amazon Kendra kunt u meerdere gegevensbronnen configureren om een ​​centrale plek te bieden om in uw documentrepository te zoeken. Voor onze oplossing laten we zien hoe u een Dropbox-repository of -map kunt indexeren met behulp van de Amazon Kendra-connector voor Dropbox. De oplossing bestaat uit de volgende stappen:

1. Configureer een app op Dropbox en ontvang de verbindingsdetails.
2. Bewaar de gegevens in AWS-geheimenmanager.
3. Maak een Dropbox-gegevensbron via de Amazon Kendra-console.
4. Indexeer de gegevens in de Dropbox-repository.
5. Voer een voorbeeldquery uit om de informatie op te halen.

Voorwaarden

Om de Amazon Kendra-connector voor Dropbox uit te proberen, heb je het volgende nodig:

Configureer een Dropbox-app en verzamel verbindingsgegevens

Voordat we de Dropbox-gegevensbron instellen, hebben we een paar details nodig over je Dropbox-repository. Laten we die van tevoren verzamelen.

1. Ga naar www.dropbox.com/developers.
2. Kies App-console.
   
3. Meld u aan met uw inloggegevens (zorg ervoor dat u zich aanmeldt bij een Enterprise-account).
   
4. Kies App maken.
   
5. kies Scoped toegang.
6. kies Volledige Dropbox (of de naam van de specifieke map die u wilt indexeren).
7. Voer een naam in voor uw app.
8. Kies App maken.
   
   U kunt het configuratiescherm zien met een reeks tabbladen.
9. Om machtigingen in te stellen, kiest u de machtigingen Tab.
   
10. Selecteer een minimale set machtigingen, zoals weergegeven in de volgende schermafbeeldingen.
    
11. Kies Verzenden.
    
    Er verschijnt een bericht dat de wijziging van de machtiging is geslaagd.
    
12. Op de Instellingen tabblad, kopieer de app-sleutel.
13. Kies Zichtbaar naast App geheim en kopieer het geheim.
14. Onder Gegenereerde toegangstoken, kiezen Genereer en kopieer de token.
    

Bewaar deze waarden op een veilige plaats - we moeten hier later naar verwijzen.

De sessietoken is maximaal 4 uur geldig. U moet elke keer dat u de inhoud indexeert een nieuwe sessietoken genereren.

Bewaar Dropbox-inloggegevens in Secrets Manager

Voer de volgende stappen uit om je Dropbox-inloggegevens op te slaan in Secrets Manager:

1. Kies op de Secrets Manager-console Bewaar een nieuw geheim.
2. Kies Ander soort geheim.
3. Maak drie sleutel-waardeparen voor appKey, appSecret en refreshToken en voer de waarden in die zijn opgeslagen vanuit Dropbox.
4. Kies Bespaar.
   
5. Voor Geheime naam, voer een naam in (bijvoorbeeld AmazonKendra-dropbox-secret).
6. Voer een optionele beschrijving in.
7. Kies Volgende.
   
8. In het Rotatie configureren sectie, bewaar alle instellingen op hun standaardwaarden en kies Volgende.
   
9. Op de Beoordeling pagina, kies Shop.
   

Configureer de Amazon Kendra-connector voor Dropbox

Voer de volgende stappen uit om de Amazon Kendra-connector te configureren:

1. Kies op de Amazon Kendra-console Maak een index.
   
2. Voor Indexnaam, voer een naam in voor de index (bijvoorbeeld my-dropbox-index).
3. Voer een optionele beschrijving in.
4. Voor Rol naam, voer een IAM-rolnaam in.
5. Configureer optionele coderingsinstellingen en tags.
6. Kies Volgende.
   
7. In het Gebruikerstoegangsbeheer configureren sectie, laat de instellingen op hun standaardwaarden en kies Volgende.
   
8. Voor Provisioning editiesselecteer Developer-editie.
9. Kies creëren.
   
   Dit creëert en verspreidt de IAM-rol en creëert vervolgens de Amazon Kendra-index, wat tot 30 minuten kan duren.
10. Kies Data bronnen in het navigatievenster.
    
11. Onder dropbox, kiezen Connector toevoegen.
    
12. Voor Naam gegevensbron, voer een naam in (bijvoorbeeld my-dropbox-connector).
13. Voer een optionele beschrijving in.
14. Kies Volgende.
    
15. Voor Type authenticatietokenselecteer Toegangstoken (tijdelijk gebruik).
16. Voor AWS Secrets Manager geheim, kies het geheim dat u eerder hebt gemaakt.
17. Voor IAM-rol, kiezen Maak een nieuwe rol.
18. Voor Rol naam, voer een naam in (bijvoorbeeld AmazonKendra-dropbox-role).
19. Kies Volgende.
    
20. Voor Selecteer entiteiten of inhoudstypen, kies uw inhoudstypen.
21. Voor Frequentie, kiezen Rennen op aanvraag.
22. Kies Volgende.
    
23. Stel eventuele optionele veldtoewijzingen in en kies Volgende.
24. Kies Beoordeel en maak En kies Gegevensbron toevoegen.
25. Kies Synchroniseer nu.
    
26. Wacht tot de synchronisatie is voltooid.
    

Test de oplossing

Nu je de inhoud van je Dropbox-account hebt opgenomen in je Amazon Kendra-index, kun je enkele zoekopdrachten testen.

Ga naar je index en kies Doorzoek geïndexeerde inhoud. Voer een voorbeeldzoekopdracht in en test uw zoekresultaten (uw zoekopdracht is afhankelijk van de inhoud van uw account).

De Dropbox-connector crawlt ook lokale identiteitsgegevens van Dropbox. Voor gebruikers stelt het de e-mail-ID van de gebruiker in als principal. Voor groepen stelt het groeps-ID in als principal. Ga naar de Search Console om zoekresultaten te filteren op gebruikers/groepen.

Klik op "Testquery met gebruikersnaam of groepen" om het uit te vouwen en klik op de knop met de tekst "gebruikersnaam of groepen toepassen'.

Voer de gebruikers- en/of groepsnamen in en klik op Solliciteer. Voer vervolgens de zoekopdracht in en druk op enter. Dit levert u een gefilterde reeks resultaten op op basis van uw criteria.

Gefeliciteerd! Je hebt Amazon Kendra met succes gebruikt om antwoorden en inzichten naar boven te halen op basis van de inhoud die is geïndexeerd vanuit je Dropbox-account.

Genereer permanente tokens voor offline toegang

De instructies in dit bericht helpen u bij het maken, configureren en gebruiken van een tijdelijk toegangstoken. Apps kunnen ook langdurige toegang krijgen door offline toegang aan te vragen. In dat geval ontvangt de app een verversingstoken dat kan worden gebruikt om zo nodig nieuwe toegangstokens van korte duur op te halen, zonder verdere handmatige tussenkomst van de gebruiker. Meer informatie vindt u in de Dropbox OAuth-handleiding en Documentatie over Dropbox-autorisatie. Gebruik de volgende stappen om een ​​permanent vernieuwingstoken te maken (bijvoorbeeld om de synchronisatie zo in te stellen dat deze volgens een schema wordt geactiveerd):

1. Verkrijg de app-sleutel en het app-geheim zoals voorheen.
2. Navigeer in een nieuwe browser naar https://www.dropbox.com/oauth2/authorize?token_access_type=offline&response_type=code&client_id=.
3. Accepteer de standaardinstellingen en kies Verzenden.
4. Kies voortzetten.
   
5. Kies Allow.
   
   Er wordt een toegangscode voor u gegenereerd.
6. Kopieer de toegangscode.
   
   Nu krijgt u het vernieuwingstoken van de toegangscode.
7. Voer in een terminalvenster de volgende curl-opdracht uit:

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

   

U kunt dit vernieuwingstoken samen met de app-sleutel en het app-geheim opslaan om een ​​permanent token te configureren in de gegevensbronconfiguratie voor Amazon Kendra. Amazon Kendra genereert het toegangstoken en gebruikt het indien nodig voor toegang.

Beperkingen

Deze oplossing heeft de volgende beperkingen:

• Bestandsopmerkingen worden niet geïmporteerd in de index
• Je hebt niet de mogelijkheid om aangepaste metadata toe te voegen voor Dropbox
• Google-documenten, -bladen en -presentaties hebben een Google-werkruimte of Google-account nodig en zijn niet inbegrepen

Conclusie

Met de Dropbox-connector voor Amazon Kendra kunnen organisaties veilig gebruikmaken van de opslagplaats van informatie die in hun account is opgeslagen met behulp van intelligent zoeken, mogelijk gemaakt door Amazon Kendra.

In dit bericht hebben we je kennis laten maken met de basis, maar er zijn veel extra functies die we niet hebben behandeld. Bijvoorbeeld:

• U kunt gebruikersgebaseerde toegangscontrole voor uw Amazon Kendra-index inschakelen en de toegang beperken tot gebruikers en groepen die u configureert
• U kunt specificeren allowedUsersColumn en allowedGroupsColumn zodat u toegangscontroles kunt toepassen op basis van respectievelijk gebruikers en groepen
• U kunt extra velden toewijzen aan Amazon Kendra-indexkenmerken en deze inschakelen voor facetten, zoeken en weergeven in de zoekresultaten
• Je kunt de Dropbox-gegevensbron integreren met de Custom Document Enrichment (CDE)-mogelijkheid in Amazon Kendra om extra logica voor het toewijzen van kenmerken uit te voeren en zelfs om aangepaste inhoudstransformatie uit te voeren tijdens opname

Raadpleeg voor meer informatie over deze mogelijkheden en meer de Amazon Kendra-ontwikkelaarsgids.

---

Over de auteur

Ashish Lagwankar is Senior Enterprise Solutions Architect bij AWS. Zijn belangrijkste interesses zijn AI/ML, serverloze en containertechnologieën. Ashish is gevestigd in de omgeving van Boston, MA en houdt van lezen, buitenshuis en tijd doorbrengen met zijn gezin.