Otwarcie API Platformy na integracje zewnętrzne

Otwieramy interfejs programistyczny (API) w celu skutecznej i stabilnej integracji z zewnętrznymi narzędziami. Taka integracja pozwala skutecznie wcielić operacje na Platformie w istniejące procesy i narzędzia Organizacji. To ogranicza nakład ludzki, zwiększa możliwości optymalnego doboru wymaganych zasobów, a same procesy przyspiesza. Może zatem stanowić sposób na realne oszczędności środków i czasu dla Użytkowników.

Poprzez API Platformy możliwe do wykonania są wszystkie te operacje, które Użytkownik może wykonać bezpośrednio w Panelu Zarządzaniu lub narzędziu CLI i są to m.in.:

• utworzenie Zasobów tj. Wirtualna Maszyna, Dysk, Obraz,
• monitorowanie stanu Zasobów,
• dodanie Adresu IP do Adaptera sieciowego,
• przyłączenie Dysku do Wirtualnej Maszyny,
• przypisanie Rezerwacji do Wirtualnej Maszyny

Szybkie wprowadzenie do API pozwala w ciągu kilku chwil poznana jak wykonać pierwsze żądania. Referencyjna dokumentacja API (opens new window) pozwala poznać każdy element Platformy. Co ważne, wykorzystuje otwarty standard OpenAPI. Ułatwia to wykorzystanie istniejących narzędzi do stworzenia integracji systemów Organizacji z Platformą.

Dokumentacji w formacie OpenAPI umożliwia zarówno programistom, jak i komputerom wykrycie i jednoznaczne zrozumienie możliwości Platformy bez konieczności analizy kodu źródłowego, lektury dodatkowych podręczników lub inspekcji ruchu sieciowego. Dzięki temu interakcja z Platformą wymaga minimalnej logiki implementacji, co obniża koszt i przyspiesza jej wykonanie. Wykorzystanie standardu OpenAPI eliminuje zgadywanie podczas wywoływania usługi, a także pozwala sprawnie śledzić zmiany, co zapewnia stabilność integracji.

Możemy zaznaczyć, że treść dokumentacji API jest automatycznie generowana dzięki odpowiedniej integracji wewnętrznych systemów Platformy. Kluczowe elementy dokumentacji są także okresowo, zewnętrznie weryfikowane. To oznacza, że wraz z rozwojem Platformy możliwości integracji będą poszerzały się, a treść dokumentacji nie ma technicznej możliwości ulec dezaktualizacji.

Dzięki wykorzystaniu Konta Usługi utworzona integracja może przyczynić się do zwiększenia bezpieczeństwa Organizacji. Konto usługi to dane dostępowe umożliwiające wykonywanie w imieniu Użytkownika dostępu do Platformy. Posiada ono określony identyfikator oraz ściśle określone prawa dostępu do wybranych elementów Platformy. Stwarza to możliwość dodatkowego zabezpieczenia użycia Platformy, aby ograniczyć dostępne operacje do ścisle określonych na wybranych Zasobach. Przykładowo zatrzymanie wyłącznie pewnej grupy Wirtualnych Maszyn.

Jest to pierwszy z etapów prac nad zewnętrznymi integracjami. Zamierzamy opracować biblioteki programistyczne dla popularnych języków programowania, aby dalej ułatwić integracje z własnymi narzędziami Organizacji oraz pracę z popularnymi narzędziami open-source.

Adam Dobrawy - Warszawa, 22 stycznia 2019 roku