Using Device Auth - 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)

After creating application using iectl publisher standalone-app create

Edge device provides capabilities to other installed applications so that they can register themselves and use authentication and authorization services.

Edge service also registered as a predefined app into auth service. Application developer can use below functionalities of this auth service:

  • User creation and session management
  • Direct user with predefine username/password
  • Sign up for app users
  • Groups
  • Invitation for a group
  • Roles and Permissions set
# examples are based on given yaml
version: "2.4" 
services: 
  nginx: #serviceName to be used in --redirectsection, to tell device to use this service for app redirection.
    image: nginx:alpine 
    restart: always 
    mem_limit: 200m

Use argument --authservice "{"servicename":"/opt/appsecrets.json"}"

$ iectl publisher standalone-app version create \
        --appname "my cool app" \
        --yamlpath "/path/to/folder/with/docker-compose.yaml" \ 
        --versionnumber "1.0.0" \
        --authservice "{"nginx":"/opt/appsecrets.json"}"
        --nginxjson '{"nginx":[{"name":"ui","protocol":"HTTPS","port":"80","headers":"","rewriteTarget":"/"}]}' \ # nginxjson is json map of docker compose service name and array of reverse proxy.
        --redirectsection "nginx" \         # redirectsection requires the service name within docker-compose which contains the container that shall be exposed
        --redirecttype "FromBoxReverseProxy" \  # redirecttype is either FromBoxSpecificPort for direct port exposure or FromBoxReverseProxy for reverse proxy exposure
        --redirecturl "ui/" \                   # redirecturl is the port which shall be exposed from your container
        --restredirecturl "" \                  # restredirecturl path will be used upon redirect to your application