Pääkäyttäjän päivitysohje: Flow'hun kirjautuminen Flow OpenAPI:lla sekä G4:n sovelluskehitin- tai task-ohjelmalla

Yleistä

Uuteen käyttäjähallintajärjestelmään (Keycloakiin tai esim. Entraan) on siirryttävä Flow 25.0 päivityksen yhteydessä. Päivitä kaikki yrityksesi OpenAPI-clientit sekä Vertex CAD Task- ja sovelluskehitinohjelmien (ent. paramerikieliset ohjelmien) autentikointiosuudet tämän ohjeen avulla.

Voit unohtaa tämän ohjeen, jos autentikointia ei tapahdu Vertex CAD Task- tai sovelluskehitinohjelmissa. Tässä ohjeessa puhutaan Keycloak-käyttäjistä, mutta samat säännöt koskevat myös muiden IDP:iden (esim. Entra) kautta kirjautuvia.

Päivitä sovelluskehitin- ja task-ohjelmat

Sovelluskehitin- ja task-ohjelmassa kirjautuminen käyttäjätunnuksella ja salasanalla ei määrittele käyttäjää Keycloakin ollessa käytössä. Sen sijaan käyttäjän pitää kirjautua interaktiivisesti Flow'hun ennen ohjelmien ajoa. Vanhat sisään- ja uloskirjautumiskomennot voi jättää ohjelmiin, mutta niiden avulla ei voi hallita käyttäjän sisään- ja uloskirjautumista. Poikkeuksena on ns. G4 Task Manager:in käyttö.

Jos käyttäjätunnusta ei ole siirretty Keycloak-käyttäjäksi, voi parametri- ja task-komentoja käyttää kuten aikaisemminkin.

Keycloak-käyttäjän kirjautuminen Flow'hun ei onnistu salasanan sisältävillä parametri- tai task-komennoilla.

Näillä parametriohjelmakomennoilla ei Keycloak-käyttäjä voi kirjautua sisään eikä ulos:

^{Login = pdm_login("käyttäjätunnus","käyttäjän salasana")}
^{Logout = pdm_logout()}

Näillä task-ohjelmakomennoilla ei Keycloak-käyttäjä voi kirjautua sisään eikä ulos:

^{#Flow.LOGIN(käyttäjätunnus, käyttäjän salasana);}
^{#Flow.LOGOUT();}

Jos ohjelman luonteesta johtuen (esimerkiksi suunnitteluautomaatit) interaktiivinen kirjautuminen ei onnistu, ota yhteys Vertex Systemsiin.

Päivitä OpenAPI-rajapintaa käyttävät ohjelmat

Uutta käyttäjähallintajärjestelmää tukeva Flow OpenAPI:n rajapinnan versio 2.0 on julkaistu Flow-version 2025 myötä. Vuosi 2025 on siirtymäaikaa ja Flow’n versiossa 2026 rajapinnan 1.0 tuki poistuu.
Yrityksesi Flow OpenAPI:a käyttävät client-ohjelmat kannattaa päivittää siirtymäaikana käyttämään 2.0-rajapintaa.

Lue Flow OpenAPI:sta lisää täältä.