Steg-för-steg-instruktion till hur ni genererar de Client ID:n och Client Secrets som behövs för 2c8-integrationen
För att integrationen mellan 2c8 och Stratsys ska fungera så behöver två API-klienter med tillhörande Client Secrets skapas i Stratsys utvecklarportal. Stegen för att generera dessa är liknande, men informationen ska in på olika ställen i 2c8.
Behöver ni hjälp med att utföra steg här så kan er Stratsys-konsult vara behjälplig med att hitta rätt. Av säkerhetsskäl är det dock viktigt att det är ni själva som genererar dessa klienter och API-nycklar.
Att hitta till Utvecklarportalen/förutsättningar
För att kunna skapa de API-klienter som behövs behöver den användare som ska skapa klienterna ha rollen Utvecklare i Stratsys Plattform. Läs mer om hur ni utför detta här.
Då användaren har rätt roll så kan denne navigera till utvecklarportalen genom att gå till följande länk: https://developers.svc.stratsys.com/[tenantId] där [tenantId] ersätts med ert kund-ID i Stratsys plattform.
Ni hittar detta ID enklast genom att logga in i plattformsadministrationen och kopiera den del av URL:en som kommer mellan "/"-tecknen. Se exempel här nedan:
I exemplet ovan så är alltså adressen till utvecklarportalen för denna kund följande:
Då ni kommit dit, klicka på "Sign in" för att logga in i utvecklarportalen.
Nu är ni inloggade och kan börja skapa klienten.
2c8 API Client
Denna klient behövs för att objekt/processer ska kunna integreras mellan 2c8 och Stratsys. För att skapa en klient av denna typ så behövs följande steg utföras:
1. Klicka på "Explore clients" i vänstermenyn, och därefter på "Add client"
2. I listan som nu visas, klicka först på "2c8 API Client" och därefter på "Add"
3. Nu har klienten skapats och fått sitt ID. Detta ID kan kopieras in i 2c8 Modeling Tool genom att klicka på "Kopiera"-ikonen till höger om ID:t.
4. För att klienten ska fungera så behöver lite ytterligare information läggas till/skapas. Först behöver vi lägga in en "External Source". Denna ska heta 2c8 om inget annat angivits. Detta är redan förifyllt och behöver således inte ändras.
5. Även en Client Secret behöver genereras. Det görs genom att klicka på knappen "Secrets".
Då öppnas följande vy där ni då ska generera en Client Secret:
OBS! En Client Secret ska aldrig delas via mejl, Teams eller på något annat sätt. Den kommer bara visas en gång då den skapas och därefter är den av säkerhetsskäl alltid dold och kan inte återfås.
Skulle något gå fel då ni lägger in den i 2c8 så behöver ni ta bort den secret som skapades först och generera en ny. Behöver ni assistans med detta så kontakta Stratsys support så kan vi guida er.
För att skapa en secret, klicka på följande:
6. Klicka först på "Add secret", ge den därefter en passande beskrivning och klicka till sist på "Save"
7. Nu kommer din secret att visas en och endast en gång. Använd Kopiera-ikonen till höger i kolumnen "Value" för att plocka ut hela värdet och klistra direkt in det i 2c8 Modeling Tool.
Frågor och svar
Hur gör jag för att byta en redan skapad Client Secret?
OBS! Innan ni lägger in en ny Client Secret, se till att radera den befintliga som redan finns där.
Detta utförs genom att i panelen med Client Secrets klicka på "minus-tecknet" längst till höger på raden och därefter klicka på "Save". Då raderas den befintliga Client Secreten och allt är redo för att lägga till en ny.
För att ersätta en befintlig secret går det bra att följa stegen 5-7 i någon av instruktionerna ovan. Innan det görs ska dock den befintliga secreten av säkerhetsskäl raderas.