Translation not up to date
Aby uzyskać dostęp do danych w usłudze Box, utwórz dla nich zasób połączenia.
Platforma Box jest usługą zarządzania treścią w chmurze i udostępniania plików.
Wymaganie wstępne: tworzenie aplikacji niestandardowej w usłudze Box
Przed utworzeniem połączenia z usługą Box należy utworzyć aplikację niestandardową w konsoli programisty Box. Można utworzyć aplikację dla dostępu na poziomie aplikacji, która może być używana przez użytkowników do współużytkowania plików, lub utworzyć aplikację dla dostępu do wszystkich kont użytkowników w całym przedsiębiorstwie. Użytkownicy, którzy mają dostęp ogólnokorporacyjny, nie muszą udostępniać plików i folderów do współużytkowania dla aplikacji.
- Przejdź do konsoli programisty Boxi postępuj zgodnie z instrukcjami kreatora, aby utworzyć aplikację niestandardową. W polu Metoda uwierzytelnianiawybierz wartość
OAuth 2.0 with JWT (Server Authentication)
. - Wybierz następujące opcje na stronie Konfiguracja . W przeciwnym razie należy zachować ustawienia domyślne.
- Wybierz jedną z dwóch opcji w polu Poziom dostępu do aplikacji:
- Pozostaw domyślną opcję Tylko dostęp do aplikacji , aby umożliwić użytkownikom współużytkowanie plików.
- Wybierz opcję Aplikacja + Dostęp korporacyjny , aby utworzyć aplikację z dostępem ogólnokorporacyjnym do wszystkich kont użytkowników.
- Pozostaw domyślną opcję Tylko dostęp do aplikacji , aby umożliwić użytkownikom współużytkowanie plików.
- W obszarze Dodaj klucze publiczne i zarządzaj nimikliknij opcję Generuj parę kluczy publiczny/prywatny. Ta opcja wymaga włączenia uwierzytelniania dwuskładnikowego na koncie Box, ale można je później wyłączyć. Wygenerowana para kluczy tworzy plik konfiguracyjny (
*_config.json
), który można pobrać. Informacje w tym pliku będą potrzebne do utworzenia połączenia w projekcie.
- Wybierz jedną z dwóch opcji w polu Poziom dostępu do aplikacji:
- Jeśli wybrano opcję App + Enterprise Access, w obszarze Funkcje zaawansowanezaznacz oba pola wyboru:
- Tworzenie wywołań interfejsu API przy użyciu nagłówka as-user
- Generuj tokeny dostępu użytkownika
- Wyślij identyfikator klienta aplikacji do administratora przedsiębiorstwa Box w celu autoryzacji: przejdź do aplikacji w konsoli programisty Box i wybierz odsyłacz Ogólne na lewym pasku bocznym aplikacji. Przewiń w dół do sekcji Autoryzacja aplikacji .
Wybierz metodę tworzenia połączenia na podstawie miejsca, w którym znajduje się platforma
- W projekcie
- Kliknij opcję Zasoby > Nowe zadanie > Połącz ze źródłem danych. Więcej informacji na ten temat zawiera sekcja Dodawanie połączenia do projektu.
- W obszarze wdrażania
- Kliknij opcję Dodaj do obszaru > Połączenie. Patrz sekcja Dodawanie połączeń do obszaru wdrażania.
- W katalogu zasobów platformy Platform assets catalog
- Kliknij opcję Nowe połączenie.
Utwórz połączenie z usługą Box
Wprowadź wartości z pobranego pliku konfiguracyjnego dla następujących ustawień:
- Identyfikator klienta
- Klucz tajny klienta
- Identyfikator przedsiębiorstwa
- Klucz prywatny (zastąp każdy znak
\n
znakiem nowego wiersza) - Hasło klucza prywatnego (wartość
passphrase
w pliku konfiguracyjnym) - Klucz publiczny (wartość
publicKeyID
w pliku konfiguracyjnym)
Aplikacja ogólnokorporacyjna
Jeśli skonfigurowano aplikację o dostępie ogólnokorporacyjnym, wprowadź nazwę użytkownika konta użytkownika Box w polu Nazwa użytkownika .
Aplikacja na poziomie aplikacji
Użytkownicy muszą jawnie udostępnić swoje pliki do współużytkowania dla adresu e-mail aplikacji, aby aplikacja mogła uzyskać do nich dostęp.
Nawiąż połączenie REST w celu uzyskania adresu e-mail aplikacji. Na przykład:
PUT https://api.dataplatform.cloud.ibm.com/v2/connections/{connection_id}/actions/get_user_info?project_id={project_id}
Treść żądania:
{}
Zwraca:
{ "login_name": "[email protected]" }
Udostępnij do współużytkowania pliki i foldery w usłudze Box, które mają być dostępne z poziomu produktu Watson Studio , używając nazwy użytkownika zwróconej przez wywołanie REST.
Następny krok: dodawanie zasobów danych z połączenia
- Patrz sekcja Dodawanie danych z połączenia w projekcie.
Miejsce, w którym można użyć tego połączenia
Połączenia z usługą Box można używać w następujących obszarach roboczych i narzędziach:
Projekty
- Data Refinery
Katalogi
- Platform assets catalog
Ograniczenie
Jeśli w folderze Box znajdują się tysiące plików, połączenie może nie być w stanie pobrać tych plików przed upływem limitu czasu. Zadania lub profilowanie używające plików Box mogą nie działać.
Obejście: zreorganizuj hierarchię plików w usłudze Box, aby w tym samym folderze było mniej plików.
Obsługiwane typy plików:
Połączenie Box obsługuje następujące typy plików: Avro, CSV, Delimited text, Excel, JSON, ORC, Parquet, SAS, SAV, SHP i XML.
Więcej inform.
Temat nadrzędny: Obsługiwane połączenia