# Exigences pour l'implémentation d'ARK par les sous-authorités nommantes et autorités d'adressage BnF

Bertrand Caron

► To cite this version:

Bertrand Caron. Exigences pour l'implémentation d'ARK par les sous-authorités nommantes et autorités d'adressage BnF. Bibliothèque nationale de France. 2023. hal-04152364v3

HAL Id: hal-04152364

https://bnf.hal.science/hal-04152364v3

Submitted on 31 Oct 2023

HAL is a multi-disciplinary open access
archive for the deposit and dissemination of sci-
entific research documents, whether they are pub-
lished or not. The documents may come from
teaching and research institutions in France or
abroad, or from public or private research centers.

L'archive ouverte pluridisciplinaire HAL, est
destinée au dépôt et à la diffusion de documents
scientifiques de niveau recherche, publiés ou non,
émanant des établissements d'enseignement et de
recherche français ou étrangers, des laboratoires
publics ou privés.

<figure><img src="image_1.png" /></figure>

Distributed under a Creative Commons Attribution 4.0 International License
Bibliothèque nationale de France

Exigences pour l'implémentation
d'ARK par les sous-autorités
nommantes et autorités
d'adressage BnF

Bibliothèque nationale
de France

direction des Services et des réseaux
département des Métadonnées
service Ingénierie des métadonnées

version 4 du 5 septembre 2023
émetteur : Bertrand CARON
affaire suivie par : Bertrand CARON
référence : BnF-ADM-2018-022324-04
<figure><img src="image_2.png" /></figure>

Table des mises à jour du document

<table><thead><tr><td>Version</td><td>Auteur</td><td>Date</td><td>Objet de la mise à jour</td></tr></thead><tbody><tr><td>v. 1</td><td>Bertrand Caron</td><td>12/03/2018</td><td>Version initiale validée.</td></tr><tr><td>v. 2</td><td>Bertrand Caron</td><td>06/03/2019</td><td>- Suppression de la recommandation « pas plus de deux lettres de suite » ;<br/>- Ajout de l'information sur le protocole dans la politique de permanence ;<br/>- Suppression de l'annexe (considérations relevant de l'urbanisation des processus).</td></tr><tr><td>v. 3</td><td>Bertrand Caron</td><td>05/07/2023</td><td>- Modifications substantielles de la structure du document avec notamment l'ajout de la section 9 sur la publication de l'identifiant ;<br/>- Ajout de notions nouvelles / modifiées par la nouvelle spécification ARK, notamment l'inflexion, considérée comme distincte des qualificatifs ;<br/>- Ajout d'une annexe listant les exigences pesant sur les applications attribuant et/ou résolvant des identifiants ARK ;<br/>- Modification du titre : il s'agit désormais d'exigences et non plus de préconisations.</td></tr></tbody></table>
<figure><img src="image_3.png" /></figure>

TABLE DES MATIERES

<table><tr><td>1. INTRODUCTION</td><td>4</td></tr><tr><td>1.1. OBJET</td><td>4</td></tr><tr><td>1.2. DOMAINE D'APPLICATION</td><td>4</td></tr><tr><td>1.3. GESTION ET EVOLUTION</td><td>4</td></tr><tr><td>2. DOCUMENTS APPLICABLES ET DE REFERENCE</td><td>4</td></tr><tr><td>3. TERMINOLOGIE</td><td>6</td></tr><tr><td>3.1. GLOSSAIRE</td><td>6</td></tr><tr><td>3.2. ABREVIATIONS</td><td>7</td></tr><tr><td>4. ENREGISTREMENT ET MEMOIRE DES IDENTIFIANTS</td><td>8</td></tr><tr><td>4.1. DEFINIR LES RESSOURCES IDENTIFIEES</td><td>8</td></tr><tr><td>4.2. CONSERVER LA MEMOIRE DES IDENTIFIANTS ATTRIBUES</td><td>8</td></tr><tr><td>4.3. ENVISAGER L'EVOLUTION DES RESSOURCES</td><td>9</td></tr><tr><td>4.3.1. Suppression</td><td>9</td></tr><tr><td>4.3.2. Dépublication ou changement de périmètre de diffusion</td><td>9</td></tr><tr><td>4.3.3. Modification substantielle de l'identité</td><td>9</td></tr><tr><td>4.3.4. Scission</td><td>9</td></tr><tr><td>4.3.5. Remplacement d'une ressource</td><td>10</td></tr><tr><td>5. GENERER DES NOMS ARK BNF</td><td>10</td></tr><tr><td>5.1. LIBELLE DE L'IDENTIFIANT</td><td>10</td></tr><tr><td>5.2. UTILISATION DU NAAN BNF</td><td>10</td></tr><tr><td>5.3. NOM ARK</td><td>10</td></tr><tr><td>5.3.1. Définition du préfixe</td><td>10</td></tr><tr><td>5.3.2. Caractère de contrôle</td><td>10</td></tr><tr><td>6. DEFINIR DES QUALIFICATIFS</td><td>11</td></tr><tr><td>6.1. QUALIFICATIFS DE GRANULARITE</td><td>11</td></tr><tr><td>6.2. QUALIFICATIFS DE SERVICE</td><td>11</td></tr><tr><td>7. RESOUDRE DES ARK</td><td>11</td></tr><tr><td>7.1. IDENTIFICATION DU NAAN</td><td>12</td></tr><tr><td>7.2. IDENTIFICATION DU PREFIXE</td><td>12</td></tr><tr><td>7.3. NORMALISATION DU NOM ARK</td><td>12</td></tr><tr><td>7.4. CALCUL DU CARACTERE DE CONTROLE</td><td>12</td></tr><tr><td>7.5. RESOLUTION DES QUALIFICATIFS</td><td>13</td></tr><tr><td>7.5.1. Résolution des qualificatifs de granularité</td><td>13</td></tr><tr><td>7.5.2. Résolution des qualificatifs de service</td><td>14</td></tr><tr><td>7.6. REDIRECTION VERS UNE URL D'ACCES</td><td>14</td></tr><tr><td>8. PERMETTRE L'INFLEXION DES ARK</td><td>14</td></tr><tr><td>8.1. METADONNEES</td><td>14</td></tr><tr><td>8.2. DECLARATION DE PERMANENCE</td><td>15</td></tr><tr><td>9. PUBLIER L'IDENTIFIANT</td><td>16</td></tr><tr><td>10. ANNEXE : LISTE DES EXIGENCES</td><td>17</td></tr><tr><td>10.1. EXIGENCES PORTANT SUR LES SOUS-AUTORITES NOMMANTES</td><td>17</td></tr><tr><td>10.2. EXIGENCES PORTANT SUR LES AUTORITES D'ADRESSAGE</td><td>17</td></tr></table>
<figure><img src="image_4.png" /></figure>

# 1. Introduction

## 1.1. Objet

Ce document détaille les exigences pour l'implémentation de l'identifiant ARK au sein de la BnF, et plus particulièrement des principes d'attribution par les sous-authorités nommantes et de résolution par les autorités d'adressage. Il réunit des exigences mentionnées par la spécification ARK et d'autres spécifiques à la BnF et considérées comme des bonnes pratiques.

Cette présente version 3 intègre les évolutions liées à la version actuelle (version 37) de la spécification (en cours de normalisation), et plus particulièrement :

- L'introduction de la forme officielle « ark:[NAAN]... » (sans barre oblique suivant les deux-points), co existant avec la forme originelle « ark:/[NAAN]... » ;

- Le remplacement des formes d'inflexion originelles (« ? » pour les métadonnées et « ?? » pour la déclaration de permanence) par une forme unique « ?info ».

## 1.2. Domaine d'application

Ce document s'applique à toutes les nouvelles sous-authorités nommantes et autorités d'adressage BnF<fnref n="1" /> ainsi qu'à celles qui rénovent leurs infrastructures. On pourra donc constater sur les applications BnF des divergences potentiellement importantes par rapport à la cible décrite ci-dessous.

En tête de chaque titre de premier niveau, on indiquera si la section concerne la sous-authorité nommante ou l'autorité d'adressage.

Ce document est également destiné :

- Aux autorités nommantes extérieures à la BnF qui désirent connaître la politique générale de la BnF concernant les ARK afin de s'en inspirer pour leur propre implémentation ;

- Aux autorités d'adressage extérieures à la BnF qui désirent réutiliser des ARK BnF pour leur propre usage.

## 1.3. Gestion et évolution

Ce document définit un cadre général à l'attribution et à la résolution des ARK à la BnF. Certaines considérations d'implémentation décrites dans les sections 7 et 8 pourront être revues, notamment à l'issue du processus de normalisation de l'identifiant ARK en cours à l'IETF.

# 2. Documents applicables et de référence

<table><thead><tr><td>Intitulé</td><td>Description</td><td>Référence</td></tr></thead><tbody><tr><td>Spécification ARK</td><td>Spécification ARK en cours de normalisation à l'IETF</td><td>https://datatracker.ietf.org/doc/draft-kunze-ark/</td></tr><tr><td>Vade-mecum sur les identifiants pérennes</td><td>Identifiants pérennes pour les ressources culturelles : vade-mecum pour les producteurs de données, version 1.0, Ministère de la Culture et de la communication : décembre 2015</td><td>https://www.culture.gouv.fr/Espace-documentation/Publications-revues/Identifiants-perennes-pour-les-ressources-numeriques</td></tr><tr><td>Registre ARK</td><td>Liste des autorités nommantes</td><td>https://n2t.net/e/pub/naanRegistry.txt</td></tr></tbody></table>

<footnote n="1">¹ C'est-à-dire à toutes les applications publiant ou manipulant des ARK dont le NAAN est celui de la BnF (12148).</footnote>
<figure><img src="image_5.png" /></figure>

http://ark.bnf.fr/services/naanRegistry.txt
<figure><img src="image_6.png" /></figure>

## 3. Terminologie

### 3.1. Glossaire

<table><thead><tr><td>Terme</td><td>Définition</td></tr></thead><tbody><tr><td>ARK compact</td><td>Chaîne de caractères d'un identifiant ARK sans le nom de domaine du résolveur, commençant donc par « ark: ».</td></tr><tr><td>Autorité d'adressage</td><td>Organisation capable de rendre un ARK actionnable en fournissant un accès à la ressource.</td></tr><tr><td>Autorité nommante</td><td>Organisation créant des associations pérennes entre des identifiants et des ressources informationnelles. L'autorité nommante peut déléguer cette création à une autre organisation.</td></tr><tr><td>Inflexion</td><td>Méthode d'appel d'un ARK en vue d'obtenir des métadonnées sur la ressource et la politique de permanence appliquée à la ressource.</td></tr><tr><td>Nom ARK</td><td>Chaîne de caractères suivant immédiatement le numéro d'autorité nommante, sans éventuels qualificatifs.</td></tr><tr><td>Numéro d'autorité nommante</td><td>Numéro sur cinq chiffres assigné par l'agence de maintenance de l'identifiant ARK (l'ARK Alliance) à une organisation.</td></tr><tr><td>Déclaration de permanence</td><td>Engagement d'une organisation à maintenir l'accès à une ressource sur une période déterminée. Elle résulte de pratiques du ressort de l'autorité nommante (le comportement en cas d'évolution de la ressource, la méthode de nommage) et du ressort de l'autorité d'adressage (les variantes proposées de la ressource sous forme de qualificatifs de service).</td></tr><tr><td>Préfixe</td><td>Élément initial du nom ARK. Composé d'un nombre défini de caractères, il est attribué par l'autorité nommante à une sous-autorité nommante.</td></tr><tr><td>Qualificatif de granularité</td><td>Qualificatif précédé du caractère « / » (barre oblique) indiquant que la ressource identifiée par le qualificatif est une composante de celle identifiée par l'ARK non qualifié.</td></tr><tr><td>Qualificatif de service</td><td>Qualificatif précédé du caractère « . » (point) indiquant que la ressource identifiée par le qualificatif est une variante de celle identifiée par l'ARK non qualifié.</td></tr><tr><td>Registre ARK</td><td>Fichier géré par l'ARK Alliance listant les organisations déclarées comme autorités nommantes et leur attribuant un NAAN.<br>Le registre ARK est répliqué chez trois institutions partenaires : la CDL, la BnF et la National Library of Medicine.</td></tr><tr><td>Ressource</td><td>On désignera par le terme de « ressource » l'objet informationnel identifié par un ARK.</td></tr><tr><td>Libellé de l'identifiant</td><td>Partie liminaire de l'identifiant définissant son type. Pour un identifiant ARK, il s'agit de l'élément « ark: ».</td></tr><tr><td>Sous-autorité nommante</td><td>Organisation ou système à laquelle l'autorité nommante a délégué la responsabilité de créer des noms ARK. La sous-autorité nommante génère des noms ARK dans un espace de noms spécifique par le biais d'un préfixe.</td></tr><tr><td>URL d'accès</td><td>URL d'accès à la ressource associée à un identifiant ARK. Cette URL, généralement différente de l'identifiant ARK sous sa forme actionnable d'URI HTTP, est susceptible d'être mise à jour régulièrement pour que l'utilisateur soit toujours redirigé vers la localisation actuelle de la</td></tr></tbody></table>
<figure><img src="image_7.png" /></figure>

<table><thead><tr><td>Terme</td><td>Définition</td></tr></thead><tbody><tr><td></td><td>ressource.</td></tr></tbody></table>

## 3.2. Abréviations

<table><thead><tr><td>Abréviation</td><td>Terme développé</td></tr></thead><tbody><tr><td>ARK</td><td>Archival Resource Key</td></tr><tr><td>CDL</td><td>California Digital Library</td></tr><tr><td>IETF</td><td>Internet Engineering Task Force</td></tr><tr><td>NAA</td><td>Name Assigning Authority (autorité nommante)</td></tr><tr><td>NAAN</td><td>Name Assigning Authority Number (numéro d'autorité nommante)</td></tr><tr><td>NMA</td><td>Name Mapping Authority (autorité d'adressage)</td></tr></tbody></table>
<figure><img src="image_8.png" /></figure>

# 4. Enregistrement et mémoire des identifiants

Cette section concerne les sous-authorités nommantes.

## 4.1. Définir les ressources identifiées

La première tâche consiste à définir quelles ressources doivent recevoir un ARK afin d'être identifiées. Cette décision résulte d'un compromis entre les besoins des utilisateurs de citer les ressources et le coût de l'engagement du maintien de l'accès aux ressources sur un temps déterminé.

Cette tâche peut consister à définir un modèle de données simplifié des ressources, de leurs composantes, leurs variantes et leurs ressources liées. Ainsi, un document numérique diffusé dans Gallica peut être modélisé de la manière suivante :

<figure><img src="image_9.png" /></figure>

## 4.2. Conserver la mémoire des identifiants attribués

**Exigence 1.** Conserver la trace de tous les identifiants ARK attribués afin de ne jamais les attribuer à nouveau à une autre ressource, quel que soit le sort de la ressource identifiée.

**Exigence 2.** En cas de suppression de la ressource, si celle-ci a été publiée et rendue citable par les utilisateurs de la BnF, conserver avec l'identifiant :

- Une description ou un intitulé permettant d'identifier sommairement la ressource ;

- La date d'attribution de l'identifiant ;

- La date de suppression de la ressource ;

- La raison de la suppression ;

- Le cas échéant, la ressource successeure.

Des cas d'évolution et la manière de les gérer sont détaillés ci-dessous.
<figure><img src="image_10.png" /></figure>

4.3. Envisager l'évolution des ressources

Une implémentation d'identifiants ARK doit répondre à deux nécessités contradictoires :
la conservation à long terme de l'association entre un identifiant et une ressource, et, bien souvent,
une évolutivité plus ou moins importante des ressources identifiées. **Pour chaque implémentation
ARK, il est donc nécessaire d'envisager les cas d'évolution suivants et, le cas échéant,
de prévoir une réponse technique appropriée.**

4.3.1. Suppression

La suppression ne peut se contenter de supprimer l'enregistrement / la ressource dans la base : il est nécessaire qu'un ARK publié continue à pointer, si ce n'est sur la ressource elle-même, au moins vers des métadonnées minimales et une information sur l'événement qui a donné lieu à la fin de l'accès à la ressource telle que diffusée originellement. En outre, une ressource de substitution peut être le cas échéant signalée à l'utilisateur.

4.3.2. Dépublication ou changement de périmètre de diffusion

La dépublication ou le changement de périmètre de diffusion, qui aboutit à l'inaccessibilité d'une
ressource dans les conditions de consultation d'origine<fnref n="2" />, ne peut se contenter de supprimer
l'enregistrement / la ressource dans la base d'origine : il est nécessaire qu'un ARK publié continue
à pointer, si ce n'est sur la ressource elle-même, au moins vers des métadonnées minimales et une
information sur l'événement qui a donné lieu à la fin de l'accès à la ressource telle que diffusée
originellement. En outre, des modalités de consultation alternatives peuvent être le cas échéant signalées
à l'utilisateur.

4.3.3. Modification substantielle de l'identité

Il est fondamental pour les utilisateurs de ressources nommées par des ARK de connaître le degré
de variabilité de la ressource<fnref n="3" />. En particulier :

- Si la ressource est strictement invariante ;

- Ou si elle peut être soumise à corrections ou enrichissement ;

- Ou enfin si elle s'accroît.

Cependant, en cas de modification substantielle de l'identité d'une ressource identifiée par un ARK
on prévoira

- Soit la création d'une nouvelle ressource et la redirection vers la nouvelle ;

- Soit, à défaut, si une telle opération n'est pas envisageable, une information dans les métadonnées de la ressource modifiée signalant la teneur de la modification.

La nature de la modification devant faire l'objet d'une telle procédure sera à définir au cas par cas, selon
des principes édictés par l'autorité nommante<fnref n="4" />.

Exemple : ark:/12148/cb41242894n

Dans certains cas bien précis, le changement de titre d'un périodique fait l'objet de la création d'une
nouvelle ressource, avec mention en zone 785 en Intermarc de la ressource nouvelle. Cette pratique
catalographique peut être considérée comme une réponse adaptée à une modification substantielle
d'une ressource identifiée par un ARK.

4.3.4. Scission

Une scission (répartition du périmètre d'une ressource sur plusieurs nouvelles ressources) doit donner
lieu à la redirection vers les différentes ressources qui correspondent au périmètre de la ressource
originelle.

<footnote n="2">2 Ainsi, une ressource jusque-là proposée sans limitation d'accès devenant accessible sur authentification ou exclusivement dans l'enceinte de l'institution serait dans ce cas.</footnote>

<footnote n="3">³ PEYRARD, Sébastien; KUNZE, John A.; TRAMONI, Jean-Philippe, « The ARK Identifier Scheme: Lessons Learnt at the BnF and Questions Yet Unanswered », dans *International Conference on Dublin Core and Metadata Applications*, oct. 2014. ISSN 1939-1366, p. 91 (« Machine-readable commitments »).
<http://dcpapers.dublincore.org/pubs/article/view/3704/1927>. Consulté le 19/02/2018.</footnote>

<footnote n="4">⁴ La spécification ARK (https://datatracker.ietf.org/doc/pdf/draft-kunze-ark-37.pdf#page=30), cite parmi les critères à étudier la similarité (la limite à partir de laquelle une chose diffère suffisamment d'une autre pour être considérée comme une ressource à part entière) et la granularité (la limite à partir de laquelle une composante ou une variante d'une chose est considérée comme une ressource à part entière).</footnote>
<figure><img src="image_11.png" /></figure>

#### 4.3.5. Remplacement d'une ressource

Le remplacement d'une ressource par une autre, qu'il soit opéré pour proposer une version plus récente d'une ressource ou pour fusionner deux ressources dont la similarité apparaît ultérieurement **ne peut se contenter de supprimer l'enregistrement / la ressource obsolète dans la base** : il est nécessaire que l'ARK publié à l'origine redirige vers la ressource nouvelle.

**Exemple** : la ressource originellement identifiée par [ark:/12148/cb33348652z](https://ark.bnf.fr/) renvoie vers la ressource par laquelle elle a été remplacée ([ark:/12148/cb32757566w](https://ark.bnf.fr/)).

## 5. Générer des noms ARK BnF

Cette section concerne les sous-authorités nommantes.

### 5.1. Libellé de l'identifiant

Un identifiant ARK produit par la BnF commence, sous sa forme compacte, par le libellé « ark:/ » et se poursuit par le NAAN de la BnF. La forme simplifiée « ark: » sera prochainement acceptée par le résolveur [http://ark.bnf.fr](http://ark.bnf.fr) mais n'est pas actuellement celle sous laquelle les ARK BnF doivent être enregistrés et publiés.

### 5.2. Utilisation du NAAN BnF

Les ARK attribués par les sous-authorités nommantes BnF utilisent le NAAN 12148 (BnF). **La responsabilité du maintien des ARK produits dans ce NAAN incombe donc à la BnF.**

### 5.3. Nom ARK

**Le nom ARK doit être opaque et ne révéler aucune information signifiante de la ressource.** De ce fait, le nom ARK doit être composé exclusivement des 29 caractères « 0123456789bcdfghjkmnpqrstvwxz » (lettres en minuscules). Les voyelles sont exclues afin d'éviter de créer fortuitement une suite de caractères signifiants. La lettre « l » l'est également en raison de la confusion possible avec le caractère « I » (i majuscule) et avec le chiffre « 1 ».

On veillera, pour le confort de l'utilisateur souhaitant citer une ressource par son ARK, à générer des noms ARK les plus courts possible<fnref n="5" />.

**Exigence 3 : n'utiliser que des caractères de l'alphabet ARK pour les noms ARK.**

#### 5.3.1. Définition du préfixe

La BnF définit des préfixes correspondant à différentes sous-authorités nommantes à qui elle délègue l'attribution de noms ARK. Le préfixe correspond donc à un **contexte d'attribution** visant à éviter que deux sous-authorités nommantes attribuent le même ARK au sein du NAAN BnF, **et non à une information descriptive sur le type de la ressource.**

**Exigence 4 : utiliser le préfixe défini par le coordinateur ARK de la BnF pour générer des ARK.**

*Note : les autorités nommantes sont incitées à prévoir dès l'origine un préfixe afin de gérer d'éventuels nouveaux contextes d'attribution.*

#### 5.3.2. Caractère de contrôle

Le dernier caractère d'un ARK BnF est un caractère de contrôle. Il a pour but d'éviter de renvoyer une erreur de type « 404 » lorsqu'un utilisateur fait une faute de frappe en appelant un ARK. En ce cas, l'application résolvant un ARK est en mesure de signaler à l'utilisateur que l'ARK est erroné et qu'il doit vérifier sa forme.

<footnote n="5">⁵ Ainsi, on pourra générer 811 valeurs distinctes pour un nom ARK comprenant un préfixe sur deux caractères, deux caractères spécifiques à la ressource parmi les 29 caractères recommandés et un caractère de contrôle. Si le nom ARK comprend trois caractères spécifiques à la ressource, ce chiffre est porté à 24 389.</footnote>
<figure><img src="image_12.png" /></figure>

Exigence 5 : générer des noms ARK dont le dernier caractère est un caractère de contrôle calculé selon la méthode décrite en section 7.4 ci-dessous.

## 6. Définir des qualificatifs

Cette section concerne les sous-authorités nommantes et les autorités d'adressage. En effet, la définition de qualificatifs pertinents peut être réalisée par l'autorité nommante et/ou par l'autorité d'adressage. À la BnF, les sous-authorités nommantes et les autorités d'adressage les définissent en concertation avec le coordinateur ARK de la BnF afin de garantir l'homogénéité des pratiques de nommage.

La spécification ARK permet d'étendre le nom ARK proprement dit par des qualificatifs. Ces derniers identifient soit des composantes (qualificatif de granularité) ou des variantes (qualificatif de service) d'une ressource afin de les rendre citables.

Formellement, publier un ARK comportant un qualificatif équivaut à publier deux ARK : l'ARK qualifié et l'ARK non qualifié. Une autorité d'adressage doit donc fournir une ressource ou à défaut des métadonnées minimales sur cette ressource en cas d'appel d'un ARK non qualifié si elle a publié un ARK qualifié correspondant.

Les contraintes spécifiques à la BnF sur la forme des qualificatifs sont les suivantes :

- Ils doivent être composés de caractères alphanumériques (la contrainte de l'opacité ne portant pas nécessairement sur les qualificatifs, les voyelles et le caractère « l » peuvent être employés) ;

- Les lettres doivent être en minuscules ;

- Le premier caractère du qualificatif de service doit être une lettre.

### 6.1. Qualificatifs de granularité

Un qualificatif de granularité suit immédiatement le nom ARK ; il est séparé de celui-ci par le caractère « / » (barre oblique). Un ARK ainsi qualifié identifie une ressource contenue dans une autre identifiée par l'ARK non qualifié. Ainsi, la ressource ark:/12148/btv1b525049362/f108 identifie la vue n° 108 du document numérique identifié par l'ARK ark:/12148/btv1b525049362.

Il est à noter que la politique de permanence appliquée à une ressource dont l'ARK comprend un qualificatif peut différer de celle appliquée à la ressource liée identifiée par le même nom ARK sans qualificatif. Ainsi, la ressource ark:/12148/cc12415m/ca3158 (composant d'un instrument de recherche) a une permanence limitée par rapport à ark:/12148/cc12415m (instrument de recherche) : si l'accès à la première est compromis en raison d'une suppression ou d'un déplacement, l'utilisateur a la garantie qu'il pourra accéder à la seconde. On notera également que les exigences d'opacité pesant sur le nom ARK peuvent être allégées.

### 6.2. Qualificatifs de service

Un qualificatif de service suit immédiatement le nom ARK ou, en cas d'utilisation d'un qualificatif de granularité, le dernier d'entre eux ; il en est séparé par le caractère « . » (point). Un ARK ainsi qualifié identifie une variante de la ressource identifiée par l'ARK non qualifié. Ainsi, la ressource ark:/12148/btv1b525049362/f108.pdf identifie une variante de la vue 108 du document numérique, identifiée par ark:/12148/btv1b525049362/f108, sous la forme d'un fichier PDF.

Il est à noter que la politique de permanence appliquée à une ressource dont l'ARK comprend un nom et un qualificatif peut différer de celle appliquée à la ressource liée identifiée par le même nom ARK sans qualificatif. Ainsi, la ressource ark:/12148/bpt6k134019r.epub a une permanence limitée par rapport à ark:/12148/bpt6k134019r : si l'accès à la première est compromis en raison d'une évolution technique, l'utilisateur a la garantie qu'il pourra accéder à la seconde.

## 7. Résoudre des ARK

Cette section concerne les autorités d'adressage.
<figure><img src="image_13.png" /></figure>

L'objectif des recommandations ci-dessous est d'éviter, autant que possible, que l'utilisateur
fournissant à une autorité d'adressage BnF un ARK, quelles que soient ses caractéristiques,
obtienne une erreur de type « 404 ». Il est donc souhaitable que les autorités d'adressage BnF
adoptent des méthodes de résolution homogènes, notamment en ce qui concerne les réponses HTTP
afin de fournir à l'utilisateur des ARK BnF le maximum d'informations pour lui permettre d'adapter
son comportement et ainsi de synchroniser efficacement ses données avec celles de la BnF.

Il est fortement recommandé que les autorités d'adressage intègrent, lors de l'évolution de leur application, des tests de non-régression afin de vérifier que les différents mécanismes de résolution détaillés dans les sections ci-dessus continuent de fonctionner normalement.

## 7.1. Identification du NAAN

Dans le cas de l'appel à l'autorité d'adressage avec un identifiant commençant par « ark: », l'application devra identifier le numéro d'autorité nommante qui suit immédiatement la chaîne citée.

Cas 1 : le NAAN est « 12148 » => passage à l'étape « identification du préfixe ».

Cas 2 : le NAAN n'est pas « 12148 » => **redirection de l'ARK concerné vers le résolveur ARK de la BnF.**

**Exigence 6a : rediriger vers le résolveur http://ark.bnf.fr si le NAAN n'est pas 12148.**

## 7.2. Identification du préfixe

Dans le cas de l'appel à l'autorité d'adressage avec un identifiant commençant par « ark:/12148/ », l'application devra identifier le préfixe qui suit immédiatement la chaîne citée.

Cas 1 : le préfixe identifie un ARK adressable par l'application => passage à l'étape « calcul du caractère de contrôle ».

Cas 2 : le préfixe n'identifie pas un ARK adressable par l'application => **redirection de l'ARK concerné vers le résolveur ARK de la BnF.**

**Exemple de cas 2 :** http://gallica.bnf.fr/ark:/12148/cb329111107 renvoie vers http://ark.bnf.fr/ark:/12148/cb329111107, lui-même renvoyant vers http://catalogue.bnf.fr/ark:/12148/cb329111107.

**Exigence 6b : rediriger vers le résolveur http://ark.bnf.fr si le préfixe n'est pas géré par l'autorité d'adressage.**

## 7.3. Normalisation du nom ARK

Le processus de résolution doit réaliser les opérations suivantes :

- Prise en compte de l'identifiant, qu'il soit sous la forme « ark:/12148 » ou « ark:12148 » ;

- Suppression des tirets et conversion de toutes les lettres en minuscule.

Pour des renseignements complémentaires sur la normalisation du nom ARK, on se référera à la spécification ARK<fnref n="6" />.

**Exigence 7 : normaliser l'ARK en prenant en compte les deux formes de l'ARK, en supprimant les tirets et en convertissant toutes les lettres en minuscules.**

## 7.4. Calcul du caractère de contrôle

Le calcul du caractère de contrôle porte sur le nom ARK (ARK non qualifié).

Table de correspondance base10 / base29 :

xdigit: 0 1 2 3 4 5 6 7 8 9 b c d f g
value: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14

<footnote n="6">⁶ Section 3.2 « Normalization and lexical equivalence ». https://datatracker.ietf.org/doc/pdf/draft-kunze-ark-37.pdf#page=20.</footnote>
<figure><img src="image_14.png" /></figure>

xdigit: h j k m n p q r s t v w x z
value: 15 16 17 18 19 20 21 22 23 24 25 26 27 28

Algorithme :

1. Vérifier que la chaîne correspond au motif « [préfixe][0-9bcdfghjkmnpqrstvwxz]* »

2. Pour chaque caractère, multiplier sa valeur en base 10 par sa position dans la chaîne, puis faire la somme.

3. Calculer le modulo base 29 de la valeur précédemment obtenue. Le caractère de contrôle correspond à ce modulo exprimé en base 29.

Cas 1 : le dernier caractère du nom ARK fourni en entrée à l'autorité d'adressage correspond au résultat de l'algorithme appliqué aux précédents caractères du nom ARK => passage à l'étape de résolution des qualificatifs éventuels.

Cas 2 : le dernier caractère du nom ARK ne correspond pas au résultat de l'algorithme => affichage d'une erreur de type « requête erronée ».

Exemples : ark:/12148/cb34533084g, ark:/12148/bpt6k3411272d.

**Exigence 8 :** Calculer le caractère de contrôle d'un ARK demandé par un utilisateur. Fournir la phrase de description de l'erreur mentionnée ci-dessus en cas d'échec.

## 7.5. Résolution des qualificatifs

Il est à noter que **l'ordre des qualificatifs de granularité est signifiant** : l'ARK <ark:/12345/ab/cd/ef> identifie une ressource contenue dans la ressource <ark:/12345/ab/cd>, elle-même contenue dans la ressource <ark:/12345/ab>. En revanche, **l'ordre des qualificatifs de service est non signifiant** : l'ARK <ark:/12145/ab.pdf.version2> est strictement équivalent à <ark:/12145/ab.version2.pdf>.

En raison de la diversité des formes que peuvent prendre des ARK qualifiés, **il est de la responsabilité de l'autorité d'adressage de définir des comportements par défaut si les qualificatifs fournis par l'utilisateur ne peuvent être traités.** Les sections 7.5.1 et 7.5.2 décrivent les principes de base de la résolution des qualificatifs et des exemples de comportements par défaut adaptés à différentes autorités d'adressage.

**Exigence 9 :** gérer un comportement par défaut si l'ARK qualifié ne peut être fourni.

Les cas de comportements par défaut abordés sont les suivants :

- Qualificatif attendu mais non présent ;

- Qualificatif pas ou plus géré pour la ressource spécifiée ;

- Qualificatif inconnu.

### 7.5.1. Résolution des qualificatifs de granularité

Les deux sections suivantes décrivent deux comportements par défaut acceptables. Il peut en exister d'autres selon les cas.

#### 7.5.1.1. Redirection vers la ressource de niveau immédiatement supérieur

Les qualificatifs de granularité sont résolus du plus spécifique au plus général. Ainsi, si l'ARK <ark:/12345/ab/cd/ef> ne peut être servi à l'utilisateur, on tente de lui fournir <ark:/12345/ab/cd> et, à défaut, <ark:/12345/ab>.

Exemple BnF Archives et manuscrits : ark:/12148/cc87367c/cc87293v ne peut être résolu ; l'autorité d'adressage fournit donc à défaut ark:/12148/cc87367c.

#### 7.5.1.2. Redirection vers la ressource précédente dans la séquence

Si les composantes d'une ressource identifiées par un ARK sont ordonnées séquentiellement et que l'ARK <ark:/12345/n12> ne peut être servi à l'utilisateur, on tente de lui fournir à la place <ark:/12345/n11>.
<figure><img src="image_15.png" /></figure>

**Exemple Gallica** : un utilisateur demande la vue n°690 d'un document numérique via l'ARK
[ark:/12148/bpt6k204254b/f690](ark:/12148/bpt6k204254b/f690). L'autorité d'adressage, constatant qu'il n'existe pas de vue avec ce
numéro, retourne la plus proche, c'est-à-dire la dernière vue du document.

7.5.2. Résolution des qualificatifs de service

Un ARK comportant plusieurs qualificatifs de service doit pouvoir être résolu quel que soit l'ordre dans lequel ces qualificatifs se présentent.

Les qualificatifs de service, s'il s'en trouve plusieurs, doivent donc être classés dans l'ordre alphabétique.
On considère généralement, à moins qu'un comportement par défaut plus pertinent soit défini
par l'autorité d'adressage, qu'un qualificatif non géré ou inconnu doit être ignoré.

Exemple : le qualificatif « epub » ne peut être résolu pour la ressource <ark:/12148/cc87367c>. L'ARK
[ark:/12148/cc87367c.epub](ark:/12148/cc87367c.epub) renvoie donc le même contenu que l'ARK [ark:/12148/cc87367c](ark:/12148/cc87367c).

7.6. Redirection vers une URL d'accès

L'autorité d'adressage doit rediriger l'utilisateur demandant une ressource par son identifiant ARK vers
la localisation actuelle de la ressource.

Exemple : http://data.bnf.fr/ark:/12148/cb16459435n redirige vers
http://data.bnf.fr/16459435/brutti_sporchi_e_cattivi_film/.

Exemples : bouton « Adresse permanente de la notice » en haut à droite des notices du catalogue Médailles et Antiques (http://medaillesetantiques.bnf.fr/ark:/12148/c33gbf0zz), champ « Permalien » en bas des pages de data.bnf.fr (http://data.bnf.fr/ark:/12148/cb16459435n).

Exigence 10 : répondre à l'ARK et servir la ressource via une page d'atterrissage comportant des métadonnées.

8. Permettre l'inflexion des ARK

Cette section concerne les sous-authorités nommantes et les autorités d'adressage : toute
autorité d'adressage résolvant des ARK BnF doit fournir à l'utilisateur des informations sur la ressource,
sa gestion et sa pérennité lorsque l'ARK est suffixé par « ?info », informations provenant de la sous-
autorité nommante.

Exigence 11 : fournir les éléments cités ci-dessous en cas d'inflexion de l'ARK par le suffixe « ?info ».

8.1. Métadonnées

Lors d'un tel appel, l'autorité d'adressage fournira les éléments suivants<sup>7</sup> :

- Identifiant ARK concerné ;

- Type de la ressource – notice descriptive, document numérique, ressource pédagogique, etc.);

- Description sommaire ou intitulé permettant de confirmer à l'utilisateur qu'il s'agit bien de la ressource qu'il cherche<fnref n="8" /> ;

- URL d'accès ;

- En cas de suppression ou dépublication :

- Type de l'événement ayant entraîné l'inaccessibilité de la ressource (suppression ou dépublication) ;

- Date de l'événement ;

- Cause de l'événement ;

- Optionnellement, agent ayant effectué l'opération ;

- Optionnellement, modalités alternatives de communication de la ressource ou ressource(s) de substitution.

<footnote n="7">7 Voir « Identifiants pérennes pour les ressources culturelles : vade-mecum pour les producteurs de données, version 1.0 », p. 10, sur https://www.culture.gouv.fr/Espace-documentation/Publications-revues/Identifiants-perennes-pour-les-ressources-numeriques.</footnote>

<footnote n="8">⁸ L'équivalent de ce que la BnF fournit en valeur de l'élément Dublin Core Title est généralement suffisant.</footnote>
<figure><img src="image_16.png" /></figure>

## 8.2. Déclaration de permanence

Cette section concerne les sous-authorités nommantes et les autorités d'adressage : la déclaration de permanence comprend en effet des éléments sur la politique de nommage mais aussi la description de services et des engagements en matière de continuité de service.

Outre les métadonnées décrites plus haut, l'inflexion de l'ARK par le suffixe « ?info » doit fournir à l'utilisateur une déclaration de permanence. Cette déclaration correspond à l'engagement pris par l'institution en matière de pérennité de l'accès<fnref n="9" />. Une déclaration de permanence doit aborder les points suivants.

### Considérations générales sur les ARK BnF

La BnF attribue des identifiants dans le domaine ARK 12148 (Bibliothèque nationale de France) selon les principes suivants.

- Aucun identifiant ARK ne sera attribué à nouveau ; c'est-à-dire qu'une fois qu'un lien entre un identifiant ARK et un objet aura été publié, ce lien devra être considéré comme unique, et ce pour une durée indéfinie.

- Les identifiants ARK attribués par la BnF ne contiennent, dans la mesure du possible, aucune information sémantique facilement reconnaissable ; cela contribue à faciliter leur utilisation indépendamment d'un contexte de temps ou de lieu.

- Les identifiants ARK attribués par la BnF contiennent un caractère de contrôle qui les garantit contre des erreurs de caractère isolées et des erreurs de transposition. Un utilisateur ayant fait une faute de frappe en tapant un ARK obtiendra une réponse HTTP 400 et un message l'informant que l'ARK fourni est erroné.

### Mutabilité des ressources

La mutabilité des ressources [définition des ressources concernées par la politique de permanence] est définie comme suit.

- [description de l'éventuelle évolution de l'identité des ressources et mécanismes permettant à l'utilisateur de l'identifier]

- [éventuels cas de scission, remplacement, suppression ou dépublication et mécanismes permettant à l'utilisateur de les identifier]

### Autorité d'adressage

L'autorité d'adressage [nom de l'application BnF concernée, nom de domaine] résout les ARK des ressources décrites ci-dessus via le protocole [HTTP/HTTPS].

Elle gère les qualificatifs de granularité et de service suivants :

- « [nom du qualificatif] » : [description du niveau de granularité ou de service],
  - [exemple] »

### Disponibilité

[Décrire les conditions de disponibilité et de continuité de service de la ressource]

[Mentionner une information de contact en cas de constat par l'utilisateur de l'inaccessibilité de la ressource.]

<footnote n="9">⁹ Voir « Identifiants pérennes pour les ressources culturelles : vade-mecum pour les producteurs de données, version 1.0 », p. 11, sur https://www.culture.gouv.fr/Espace-documentation/Publications-revues/Identifiants-perennes-pour-les-ressources-numeriques.</footnote>
<figure><img src="image_17.png" /></figure>

# 9. Publier l'identifiant

Cette section concerne les autorités d'adressage.

Il est fondamental de noter que seule la publication d'un identifiant ARK, clairement indiqué comme objet de l'engagement de pérennité de la BnF, engage l'établissement à maintenir l'association entre l'ARK en question et la ressource concernée, dans son identité d'origine.

Il est fondamental d'orienter l'utilisateur vers la forme préférentielle de l'identifiant afin qu'il ne soit pas tenté de copier-coller le contenu de la barre d'URL.

Note : l'URL d'accès aux ressources de la plupart des applications BnF, notamment le Catalogue général et Gallica comporte l'ARK, mais la forme de l'ARK citable reste celle qui est mentionnée dans la notice ou le cartouche de citation affiché sur la page.

Exigence 12 : publier l'identifiant à la fois sous sa forme d'ARK compact (sans le schéma d'URI et le nom de domaine) comme un élément de métadonnées et sous sa forme d'URI actionnable par l'adjonction du nom de domaine du résolveur (http://ark.bnf.fr).

Ainsi, sur le Catalogue général, ces exigences sont satisfaites de la manière suivante :

<figure><img src="image_18.png" /></figure>
<figure><img src="image_19.png" /></figure>

# 10. Annexe : liste des exigences

## 10.1. Exigences portant sur les sous-authorités nommantes

<table><thead><tr><td>Numéro</td><td>Description</td><td>Niveau de conformité</td></tr></thead><tbody><tr><td>1</td><td>Conserver la trace de tous les identifiants ARK attribués afin de ne jamais les attribuer à nouveau à une autre ressource, quel que soit le sort de la ressource identifiée.</td><td></td></tr><tr><td>2</td><td>En cas de suppression de la ressource, si celle-ci a été publiée et rendue citable par les utilisateurs de la BnF, conserver avec l'identifiant :<ul><li>Une description ou un intitulé permettant d'identifier sommairement la ressource ;</li><li>La date d'attribution de l'identifiant ;</li><li>La date de suppression de la ressource ;</li><li>La raison de la suppression ;</li><li>Le cas échéant, la ressource successeure.</li></ul></td><td></td></tr><tr><td>3</td><td>N'utiliser que des caractères de l'alphabet ARK pour les noms ARK.</td><td></td></tr><tr><td>4</td><td>Utiliser le préfixe défini par le coordinateur ARK de la BnF pour générer des ARK.</td><td></td></tr><tr><td>5</td><td>Générer des noms ARK dont le dernier caractère est un caractère de contrôle calculé selon la méthode décrite en section 7.4 ci-dessus.</td><td></td></tr></tbody></table>

## 10.2. Exigences portant sur les autorités d'adressage

<table><thead><tr><td>Numéro</td><td>Description</td><td>Niveau de conformité</td></tr></thead><tbody><tr><td>6a</td><td>Rediriger vers le résolveur http://ark.bnf.fr si le NAAN n'est pas 12148.</td><td></td></tr><tr><td>6b</td><td>Rediriger vers le résolveur http://ark.bnf.fr si le préfixe n'est pas généré par l'autorité d'adressage.</td><td></td></tr><tr><td>7</td><td>Normaliser l'ARK en prenant en compte les deux formes de l'ARK, en supprimant les tirets et en convertissant toutes les lettres en minuscules.</td><td></td></tr><tr><td>8</td><td>Calculer le caractère de contrôle d'un ARK demandé par un utilisateur. Fournir la phrase de description de l'erreur mentionnée ci-dessus en cas d'échec.</td><td></td></tr><tr><td>9</td><td>Gérer un comportement par défaut si l'ARK qualifié ne peut être fourni.</td><td></td></tr><tr><td>10</td><td>Répondre à l'ARK et servir la ressource via une page d'atterrissage comportant des métadonnées.</td><td></td></tr><tr><td>11</td><td>Fournir les éléments cités dans la</td><td></td></tr></tbody></table>
<figure><img src="image_20.png" /></figure>

<table><tr><td></td><td>section 8.2 en cas d'inflexion de l'ARK par le suffixe « ?info ».</td><td></td></tr><tr><td>12</td><td>Publier l'identifiant à la fois sous sa forme d'ARK compact (sans le schéma d'URI et le nom de domaine) comme un élément de métadonnées et sous sa forme d'URI actionnable par l'adjonction du nom de domaine du résolveur (http://ark.bnf.fr).</td><td></td></tr></table>