Offset for token issue timestamp - Manual - Industrial Edge - Industrial Edge - Industrial Edge - Documentation of Industrial Edge APIs - CLI tools - Industrial Edge - References - APIs

Industrial Edge Platform Operation - APIs & References

Product
Industrial Edge
Edition
12/2024
Language
en-US (original)

Currently the /config endpoint allows the user to manage a allowed time offset for OIDC generated tokens. This feature becomes particularly valuable when the OIDC Provider and the Device (IED) are synchronized to different NTP Servers, resulting in a slight offset of the token's issued timestamp and therefore forbidding the login with the provided token. An example error when this happens is shown in the following image:

time-offset-error

In the given example, the error shows a time offset of 5 seconds between the two timestamps.

NOTICE

The displayed timestamps already include the configured offset.

For example, if the configured offset was set to 10 seconds, the total time difference between the servers would be 15 seconds. This means that the minimum allowed offset of 15 seconds is required for a successful login in this particular setup.

To configure the time offset or ClockSkew the API can be used as following:

Log into the Edge Device as admin, like described in the previous chapter and use the access_token for the config call.

curl -X POST \
  'https://<ip of device>/device/edge/auth/api/v1/oidc-providers/config' \
  --header 'Accept: */*' \
  --header 'Authorization: {{access_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
      "oidcClockSkew": 6000
    }'