Getting Started

Cette page vous guide pour démarrer rapidement avec TOSIAM.

Prérequis

  • Installer un java JDK 11, 17 ou 21 (La variable d’environnement JAVA_HOME doit être définie.)

Installation

Télécharger la distribution Quick Start de TOSIAM. Extraire l’archive dans un répertoire <ROOT>. Un répertoire tosiam-quickstart-3.35.0 est créé. C’est la racine de la distribution (répertoire <INSTALL>)

Démarrage

Un serveur TOSIAM basé sur un serveur Tomcat 11 est lancé puis configuré automatiquement. Accéder à la Console d’admin et connectez avec le compte amadmin/password

okLa console se présente ainsi:

Console d'administration TOSIAM

Notes
  • Le répertoire de données de TOSIAM est <INSTALL>/data
  • Pour arrêter le serveur TOSIAM, utiliser la commande tosiam(.sh|.bat) down
  • Pour supprimer une configuration existante en vue de repartir de zéro, utiliser la commande tosiam(.sh|.bat) down (si serveur up), puis tosiam(.sh|.bat) delete

Scripter une configuration

TOSIAM s’appuie sur l’outil en ligne de commmande ssoadm pour configurer par script un serveur TOSIAM. La distribution TOSIAM QuickStart permet d’invoquer facilement cet outil. Nous allons à titre d’exemple créer un realm, élément de base d’une configuration.

Ouvrez une fenêtre Terminal (bash sur linux, cmd pour Windows) depuis le répertoire <INSTALL>

Depuis la console, vous pouvez constater la présence du realm ref:
Console d'administration TOSIAM avec Realm

Connexion sécurisée au serveur

TOSIAM implémente des protocoles de sécurité qui impliquent une connexion en HTTPS, même en DEV (Exemple: WebAuthn) Quickstart est configuré pour écouter sur le port 8443 en https. Le certificat racine se trouve dans le répertoire pki de la distribution (fichier quickstartCA.crt). Vous devez l’enregistrer sur votre machine de telle sorte qu’il soit accessible par votre browser.

Modifier cette page sur GitHub