dcmsign - En ligne dans le Cloud

PROGRAMME:

Nom

dcmsign - Signer et vérifier les fichiers DICOM

SYNOPSIS

dcmsign [options] dcmfile-in [dcmfile-out]

DESCRIPTION

L'exposition dcmsign L'utilitaire lit un fichier DICOM (dcmfile-in), effectue une signature numérique
opération et, si une modification a eu lieu, écrit l'objet DICOM dans une sortie
déposer (dcmfile-sortie).

Cinq opérations de signature numérique sont prises en charge :

· vérification de toutes les signatures dans le fichier DICOM
· création d'une nouvelle signature numérique située dans le jeu de données principal,
· création d'une nouvelle signature numérique dans un élément d'une séquence intégrée au
base de données,
· suppression d'une seule signature numérique du fichier DICOM, et
· suppression de toutes les signatures numériques du fichier DICOM.

PARAMETRES

dcmfile-in nom du fichier d'entrée DICOM à traiter

dcmfile-out nom du fichier de sortie DICOM

OPTIONS

général Options
-h --aide
imprimer ce texte d'aide et quitter

--version
imprimer les informations sur la version et quitter

--arguments
imprimer les arguments de ligne de commande étendus

-q --silencieux
mode silencieux, n'imprime aucun avertissement ni erreur

-v --verbeux
mode verbeux, détails de traitement d'impression

-d --débogage
mode de débogage, imprimer les informations de débogage

-ll --log-level [l] niveau : chaîne constante
(fatal, erreur, avertissement, info, débogage, trace)
utiliser le niveau l pour l'enregistreur

-lc --log-config [fichier] nom de fichier : chaîne
utiliser le fichier de configuration f pour l'enregistreur
contribution Options
format de fichier d'entrée :

+f --read-fichier
lire le format de fichier ou l'ensemble de données (par défaut)

+fo --read-file-only
lire le format de fichier uniquement

-f --read-ensemble de données
lire l'ensemble de données sans les méta-informations du fichier

syntaxe de transfert d'entrée :

-t= --read-xfer-auto
utiliser la reconnaissance TS (par défaut)

-td --read-xfer-detect
ignorer le TS spécifié dans l'en-tête méta du fichier

-te --read-xfer-petit
lire avec VR explicite little endian TS

-tb --read-xfer-big
lire avec VR explicite big endian TS

-ti --read-xfer-implicite
lire avec VR implicite TS little endian
Signature commandes
--Vérifier
vérifier toutes les signatures (par défaut)

+s --sign [fichier de clé privée, [c] fichier de certificat : chaîne
créer une signature dans l'objet principal

+si --sign-item [key]eyfile, [c]ertfile, [i]tem emplacement : chaîne
créer une signature dans l'élément de séquence

+r --remove [s] signature UID : chaîne
supprimer la signature

+ra --supprimer-tout
supprimer toutes les signatures de l'ensemble de données
Signature création Options (seulement avec --signe or --sign-item) :
mot de passe de la clé privée :

+ps --std-passwd
inviter l'utilisateur à saisir le mot de passe sur stdin (par défaut)

+pw --use-passwd [p]mot de passe : chaîne
utiliser le mot de passe spécifié

-pw --null-passwd
utiliser une chaîne vide comme mot de passe

format de fichier de clé et de certificat :

-pem --pem-clés
lire les clés/certificats en tant que fichier PEM (par défaut)

-der --der-clés
lire les clés/certificats en tant que fichier DER

profil de signature numérique :

-pf --profile-aucun
n'applique aucun profil de signature (par défaut)

+pb --profile-base
appliquer le profil de signature RSA de base

+pc --profile-créateur
appliquer le profil de signature RSA du créateur

+pa --profile-auth
appliquer le profil de signature d'autorisation

Algorithme MAC :

+monsieur --mac-ripemd160
utiliser RIPEMD 160 (par défaut)

+ms --mac-sha1
utiliser SHA-1

+mm --mac-md5
utiliser MD 5

sélection de balises :

-t --balise
[t]ag : "gggg,eeee" ou nom du dictionnaire
signer uniquement la balise spécifiée
(cette option peut être spécifiée plusieurs fois)

-tf --tag-file [fichier] nom de fichier : chaîne
lire la liste des balises du fichier texte

format de signature :

-fn --format-nouveau
utiliser le format de signature DICOM correct (par défaut)

-fo --format-ancien
utiliser l'ancien format de signature DCMTK (pré-3.5.4), non conforme
si la signature comprend des données de pixels compressées
sortie Options
syntaxe de transfert de sortie :

+t= --write-xfer-même
écrire avec le même TS en entrée (par défaut)

+te --write-xfer-petit
écrire avec un TS VR little endian explicite

+tb --write-xfer-big
écrire avec un TS big endian VR explicite

+ti --write-xfer-implicite
écrire avec VR implicite TS little endian

codage de longueur dans les séquences et les éléments :

+e --longueur-explicite
écrire avec des longueurs explicites (par défaut)

-e --longueur-indéfinie
écrire avec des longueurs indéfinies

autres options de sortie :

+d --dump [fichier] nom de fichier : chaîne
vidage du flux d'octets introduit dans le codec MAC dans un fichier
(uniquement avec --sign ou --sign-item)

NOTES

Documents officiels et Paramètres
L'exposition dcmsign L'utilitaire lit et écrit un certain nombre de fichiers et de formats de fichiers qui sont
décrit dans cette section.
Les certificats de clé publique sont attendus au format X.509v3, avec encodage PEM ou DER.
L'utilitaire dcmsign prend actuellement en charge les clés publiques RSA et DSA, bien que seules les clés RSA soient
définit dans les profils de sécurité de la norme DICOM.
Les clés privées sont attendues en codage PEM ou DER. PEM est recommandé (et par défaut) car
cela permet de conserver les clés privées sous forme cryptée. Les options de ligne de commande contrôlent le
le comportement de dcmsign lorsqu'une clé PEM cryptée est ouverte (voir ci-dessus). En général ce n'est pas
recommandé de spécifier le mot de passe de cryptage dans la ligne de commande car la commande
La ligne peut être visible par d'autres processus du système, par exemple 'ps -ef'.
La liste des éléments de données à signer peut être soit lue à partir d'un fichier, soit spécifiée sur le
ligne de commande ou les deux (dans ce cas, les touches sont combinées).
Sur la ligne de commande, les clés d'attribut sont spécifiées comme
--tag "gggg,eeee" où gggg et eeee sont le groupe hexadécimal
et numéros d'éléments
--tag "Nom" où 'Nom' est un nom d'attribut symbolique de
le dictionnaire DICOM (voir ci-dessous).
Lorsque les balises d'attribut sont lues à partir du fichier avec le --tag-fichier option, un fichier texte brut de
max. 64 ko sont attendus. Les balises dans le fichier sont soit des noms symboliques des données
dictionnaire ou avoir le format (gggg,eeee) (avec accolades). Les balises sont séparées par une ou plusieurs
caractères d'espacement.
L'exposition --sign-item l'opération nécessite une chaîne d'emplacement qui décrit dans quel élément de séquence
une signature doit être créée. La chaîne de localisation a le format suivant :
NomSéquence[index].NomSéquence[index].NomSéquence[index](...)
où SequenceName est soit un nom d'attribut symbolique du dictionnaire de données, soit un
balise numérique au format (gggg,eeee) et index est un entier décimal non signé pour le
numéro d'article, commençant par zéro pour le premier article d'une séquence. A titre d'exemple, le
chaîne de localisation suivante
ReferencedSeriesSequence[0].ReferencedImageSequence[1]
entraînerait la création d'une signature numérique dans le deuxième élément du
ReferencedImageSequence (0008,1140) qui se trouve dans le premier élément du
ReferencedSeriesSequence (0008,1115) qui se trouve dans le jeu de données DICOM principal.

Journalisation

Le niveau de sortie de journalisation des divers outils de ligne de commande et des bibliothèques sous-jacentes peut
être spécifié par l'utilisateur. Par défaut, seuls les erreurs et les avertissements sont écrits dans la norme
flux d'erreurs. Utilisation de l'option --verbeux également des messages d'information comme les détails du traitement
sont rapportés. Option --déboguer peut être utilisé pour obtenir plus de détails sur l'activité interne,
par exemple à des fins de débogage. D'autres niveaux de journalisation peuvent être sélectionnés à l'aide de l'option --Journal-
niveau. En --silencieux mode seules les erreurs fatales sont signalées. Dans des événements d'erreur aussi graves,
l'application se terminera généralement. Pour plus de détails sur les différents niveaux de journalisation,
voir la documentation du module 'oflog'.
Dans le cas où la sortie de journalisation doit être écrite dans un fichier (éventuellement avec rotation du fichier journal),
vers syslog (Unix) ou l'option du journal des événements (Windows) --log-config peut être utilisé. Cette
le fichier de configuration permet également de diriger uniquement certains messages vers une sortie particulière
flux et pour filtrer certains messages en fonction du module ou de l'application où ils
Sont générés. Un exemple de fichier de configuration est fourni dans /logger.cfg.

COMMAND LINE

Tous les outils de ligne de commande utilisent la notation suivante pour les paramètres :
valeurs facultatives (0-1), trois points de fin indiquent que plusieurs valeurs sont autorisées
(1-n), une combinaison des deux signifie 0 à n valeurs.
Les options de ligne de commande se distinguent des paramètres par un signe '+' ou '-' en tête,
respectivement. Habituellement, l'ordre et la position des options de ligne de commande sont arbitraires (c'est-à-dire qu'ils
peut apparaître n'importe où). Cependant, si les options s'excluent mutuellement, l'apparence la plus à droite
est utilisé. Ce comportement est conforme aux règles d'évaluation standard des shells Unix courants.
De plus, un ou plusieurs fichiers de commandes peuvent être spécifiés en utilisant un signe '@' comme préfixe pour
le nom du fichier (par exemple @commande.txt). Un tel argument de commande est remplacé par le contenu de
le fichier texte correspondant (les espaces blancs multiples sont traités comme un seul séparateur sauf si
ils apparaissent entre deux guillemets) avant toute évaluation ultérieure. Veuillez noter que
un fichier de commandes ne peut pas contenir un autre fichier de commandes. Cette approche simple mais efficace
permet de résumer les combinaisons courantes d'options/paramètres et évite les
lignes de commande confuses (un exemple est fourni dans le fichier /dumppat.txt).

ENVIRONNEMENT

L'exposition dcmsign L'utilitaire tentera de charger les dictionnaires de données DICOM spécifiés dans le
Dcmdictpath variable d'environnement. Par défaut, c'est-à-dire si le Dcmdictpath variable d'environnement
n'est pas défini, le fichier /dicom.dic sera chargé à moins que le dictionnaire ne soit construit
dans l'application (par défaut pour Windows).
Le comportement par défaut doit être préféré et le Dcmdictpath variable d'environnement uniquement
utilisé lorsque des dictionnaires de données alternatifs sont nécessaires. Les Dcmdictpath variable d'environnement
a le même format que le shell Unix PATH variable en ce qu'un deux-points (':') sépare
entrées. Sur les systèmes Windows, un point-virgule (';') est utilisé comme séparateur. Le dictionnaire de données
le code tentera de charger chaque fichier spécifié dans le Dcmdictpath variable d'environnement. Ce
est une erreur si aucun dictionnaire de données ne peut être chargé.

DROIT D'AUTEUR

Copyright (C) 2000-2014 par OFFIS eV, Escherweg 2, 26121 Oldenburg, Allemagne.

Utilisez dcmsign en ligne à l'aide des services onworks.net