1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
## Situation
L'instance Charente-Maritime veut partager un ensemble de données avec l'instance Nouvelle-Aquitaine.
Le serveur dit « hôte » est celui de Charente-Maritime.
Le serveur dit « client » est celui de Nouvelle-Aquitaine.
## Configuration du serveur hôte
Cette configuration est à faire si vous souhaitez donner un accès en lecture à vos données depuis une autre instance Ishtar.
Dans notre exemple, il s'agit du serveur Charente-Maritime.
Préalablement à cette configuration vous avez besoin de l'adresse IP du serveur de l'autre instance Ishtar.
### Création d'un utilisateur système
Contrairement à la création d'utilisateur classique, on créé un utilisateur système. Celui-ci n'aura pas accès à l'instance Ishtar directement.
Créer cet utilisateur en interface « Administration de base de données » : « Authentification et autorisation > Utilisateurs > Ajout ».
Utiliser un identifiant qui n'existe pas encore en base de données, exemple « syndication-nouvelle-aquitaine ».
Le mot de passe ne sera pas utilisé : en choisir un particulièrement complexe.
### Associer un jeton d'authentification à un utilisateur système
Associer ensuite à ce compte un jeton d'authentification. Depuis l'interface « Administration de base de données » : « Accueil > Jeton d'authentification > Jetons > Ajout ».
Le compte est retrouvé via l'icône loupe.
Une fois le jeton créé, aller à la liste des jetons puis mettre de côté la clé du jeton.
Par exemple sur la capture d'écran, la clé est a14b32f31029216da11621ba5ddb0431997ca61d`.
Une fois la configuration terminée, cette clé sera à transmettre à l'administrateur de l'autre instance Ishtar.
### Associer l'adresse IP du serveur client à l'utilisateur système
Depuis « Ishtar - Commun > API - Accès distant - Utilisateurs > Ajout », on associe l'utilisateur système à l'adresse IP du serveur.
Pour notre exemple, le serveur de Nouvelle-Aquitaine a l'adresse `8.8.8.8`.
### Ouvrir l'accès à un ou plusieurs types de contenu
Pour chaque type de contenu que l'on souhaite ouvrir (Opération, Unité d'Enregistrement, Mobilier, ...), ajouter une entrée via : « Ishtar - Commun > API - Accès distant - Modèles de recherche > Ajout ».
On sélectionne notre utilisateur système, le type de contenu, ainsi qu'éventuellement une requête filtrante.
Cette requête correspond à une chaîne de caractères correspondant à recherche. Seuls les éléments correspondants à cette requête seront partagés.
Si l'on ne renseigne pas cette requête filtrante tous les éléments seront renvoyés.
### Filtrer la fiche de contenu
Il est possible de cacher certains champs sur la fiche que l'on partage.
Pour chaque champ que l'on souhaite cacher, ajouter une entrée via « Ishtar - Commun > API - Accès distant - Filtres de fiche > Ajout ».
Le formulaire doit rempli en deux fois. On se contente d'abord de choisir le type de contenu que l'on veut filtrer.
Valider avec le bouton « Enregistrer et continuer les modifications ».
Une fois ce premier enregsitrement, l'aide disponible sous le champ « Clé » liste les différentes clés correspondant au contenu que l'on souhaite filtrer.
Sur cet exemple, on souhaite filtrer l'affichage de l'image principale.
Note : si l'on souhaite qu'aucune image ne soit affichée, il faut ajouter chaque champ « image ».
## Configuration du serveur client
Cette configuration est à faire si vous souhaitez accéder à des données d'une autre instance Ishtar depuis votre propre instance.
Dans notre exemple, il s'agit du serveur Nouvelle-Aquitaine.
Préalablement à cette configuration vous avez besoin du jeton d'authentification donné par le serveur hôte ainsi que l'adresse web pour accéder à celui-ci.
### Créer la source externe
Cette source externe se créé en interface « Administration de base de données » : « Ishtar - Commun > API - Recherche - Sources externes > Ajout ».
Sur le formulaire reprendre l'adresse web du serveur hôte ainsi que le jeton d'authentification qui vous a été fourni. Le nom renseigné doit être explicite, il apparaîtra sur les écrans de recherche de l'interface.
On renseigne explicitement chaque utilisateur qui aura accès à cette source externe.
### Synchroniser les listes de vocabulaire contrôlées depuis la source
Une fois la source externe créée il est nécessaire de récupérer les listes de vocabulaire contrôlées de cette source (le serveur hôte). Pour cela, on se rends sur la page listant les sources externes : « Ishtar - Commun > API - Recherche - Sources externes ». Sélectionner la source externe concernée, l'action « Mettre à jour les types depuis la source » et valider (le bouton « Aller »).
Cette action peut prendre un certain temps. Si des changements sont faits sur les listes de vocabulaires contrôlés sur la source cette étape ainsi que les suivantes sont à ré-effectuer.
### Générer la liste de correspondance
|
