Υπηρεσία Απόδοσης Ονομάτων Χρήστη uLookup

Το αντικείμενο της Υπηρεσίας uLookup είναι η εύρεση και η παρουσίαση των ρόλων των φυσικών προσώπων εντός ενός ιδρύματος, όπως και η επιβεβαίωση απόδοσης ενός όνομα χρήστη και η πρόταση νέων.

Πρόκειται για μία Υπηρεσία η οποία έρχεται να συμπληρώσει την Identity Management Υπηρεσία και να την κάνει πιο προσπελάσιμη, τόσο από το προσωπικό των Ιδρυμάτων που χρησιμοποιούν την Identity Management Υπηρεσία, όσο και υπηρεσιών που είναι διασυνδεδεμένες με αυτή.

Για λεπτομέρειες της υπηρεσίας και αναλυτικές οδηγίες για προγραμματιστές μπορείτε να δείτε τον οδηγό προγραμματιστών εδώ

Docker Compose Test stack

Η GUNet προκειμένου να διευκολύνει την ανάπτυξη interfaces με την υπηρεσία uLookup προσφέρει ένα ολοκληρωμένο δοκιμαστικό Docker compose stack το οποίο περιλαμβάνει:

• To uLookup backend (με δοκιμαστικό ApiKey με τιμή 1234)
• Δοκιμαστικό LDAP server
• Βάση MariaDB με κατάλληλα tables που προσομοιάζουν στα αντίστοιχα views πληροφοριακών συστημάτων ιδρυμάτων (HRMS, SIS, ELKE)

Για τη λειτουργία απαιτούνται τα αρχεία docker-compose.yml, docker-compose.test.yml και config.env.test τα οποία είναι διαθέσιμα στο repo. Προτείνεται ένα git clone του repo για την ευκολότερη εκτέλεση του stack

API Key

Το API key έχει όνομα ApiKey και τιμή 1234. Για μεγαλύτερη ευκολία δεν είναι ενεργοποιημένο εξαρχής (οπότε HTTP requests θα ολοκληρωθούν κανονικά). Προκειμένου να δοκιμαστεί το flow που θα προσομοιάζει περισσότερο στην παραγωγή προτείνεται να ενεργοποιηθεί αφού ολοκληρωθεί η αρχική ανάπτυξη επικοινωνίας με το uLookup API. Τα αντίστοιχα πεδία στο αρχείο config.env.test είναι τα εξής:

AUTH_ENABLED=disabled (enabled για ενεργοποίηση του API key)
TOKEN_HEADER=ApiKey
TOKENS=1234

Ενεργοποίηση - Λειτουργία

Για την ενεργοποίηση του stack απαιτούνται οι παρακάτω ενέργειες:

• Εγκατάσταση Docker
• Pull των images (προαιρετικό, θα εκτελεστεί από το docker compose up): docker compose -f docker-compose.yml -f docker-compose.test.yml pull
• Ενεργοποίηση του stack: docker compose -f docker-compose.yml -f docker-compose.test.yml up -d
• Έλεγχος καλής λειτουργίας (τα αντίστοιχα services Θα πρέπει να εμφανίζονται ως healthy): docker compose -f docker-compose.yml -f docker-compose.test.yml ps

NAME                     COMMAND                  SERVICE             STATUS              PORTS
ulookup-test-db-1        "docker-entrypoint.s…"   db                  running (healthy)   3306/tcp
ulookup-test-ldap-1      "/opt/bitnami/script…"   ldap                running (healthy)   1389/tcp, 1636/tcp
ulookup-test-ulookup-1   "java -jar ulookup.j…"   ulookup             running (healthy)   0.0.0.0:8080->8080/tcp, :::8080->8080/tcp

Στη συνέχεια μπορεί να γίνει προσπέλαση του uLookup στην πόρτα 8080 με το ApiKey 1234:

curl -x POST --location 'http://localhost:8080/api/v2/validator' \
--header 'Content-Type: application/json' \
--header 'ApiKey: 1234' \
--data '{
    "loginName": "gunetdemo"
}'

Τυπικά SSN που είναι ενεργοποιημένα είναι:

• 12312312312

Τυπικά usernames που είναι ενεργοποιημένα είναι:

• gunetdemo
• test