x11-ssh-askpass − une boîte de dialogue X11 de demande de mot de passe à utiliser avec OpenSSH

x11-ssh-askpass [options] [label]

DESCRIPTION

x11-ssh-askpass est une une boîte de dialogue X11 de demande de mot de passe (passphrase) à utiliser avec OpenSSH. Le programme ssh-add(1) l’appelle, et il n’est pas lancé directement par l’utilisateur.

x11-ssh-askpass supporte la plupart des options des boîtes à outils graphiques, à l’exception des suivantes : -geometry, -borderwidth, -iconic, -rv, et -title. Voir X(1).

Si une et une seule non-option est fournie sur la ligne de commande, x11-ssh-askpass l’affiche dans la boîte de dialogue à la place de l’étiquette par défaut. Si cet argument contient le caractère nouvelle ligne (newline) « \n », x11-ssh-askpass affiche chaque ligne de texte sur une ligne différente dans la boîte de dialogue.

Les fonctionnalités de x11-ssh-askpass sont les suivantes :

− Nécessite seulement les librairies X11 de base (libXt, libX11, libSM, libICE).

− Configurable pour utiliser le clavier et/ou la souris (par défaut, n’utilise que le clavier et pas la souris).

L’interface utilisateur est assez différente de la plupart des boîtes de dialogue de demande de mots de passe, et est plus proche de la boîte de dialogue X11 fournie avec la distribution de SSH habituelle. à la place d’un champ textuel qu’on emplit avec des astérisques ou d’autres caractères quand on saisit un mot de passe, une série de zones qui ressemblent à des diodes s’allument l’une après l’autre à chaque caractère saisi, à partir du bord gauche. Quand les diodes atteignent le bord droit, elles s’éteignent une par une, et ainsi de suite ... Ceci permet à l’utilisateur de voir qu’il a saisi un caractère, mais ne donne aucune indication sur la longueur du mot de passe.

Quand on appuie sur le bouton « OK », on valide le mot de passe (même s’il est vide), qui est affiché sur la sortie standard, et la boîte de dialogue se termine avec un code de retour de 0 (succès). Si on appuie sur le bouton « Cancel », on annule le mot de passe, et la boîte de dialogue se ferme avec un code de retour non nul.

Les saisies des séquences suivantes fonctionnent comme décrit ci-après :

[<--]’
[Suppr]’ Efface le caractère précédent

[Ctrl+U]’
[Ctrl+X]’ Efface le mot de passe en entier

[Entrée]’
[Ctrl+M]’
[Ctrl+J]’ Valide le mot de passe (OK)

[Ãchap]’ Annule le mot de passe (Cancel)

WIDGETS

La fenêtre principale de x11-ssh-askpass dispose d’une hiérarchie de widgets (éléments graphiques) comme décrite ci-après. Le nom de la classe du widget apparaît en premier, suivi du nom de l’instance.

dialog

Indicator
indicator
Button’ okButton
Button’ cancelButton

RESSOURCES

Les ressources suivantes sont utilisées pour personnaliser globalement l’application :

Spécifie si l’application doit utiliser le clavier.
Par défaut « True ».

grabPointer (classe GrabPointer)
Spécifie si l’application doit utiliser la souris.
Par défaut « False ».

grabServer (classe GrabServer)
Spécifie si l’application doit utiliser le serveur.
Par défaut « False ».

inputTimeout (classe InputTimeout)
Nombre de secondes d’attente avant d’appuyer sur une touche du clavier ou sur un bouton de la boîte de dialogue. Si cette temporisation est dépassée, x11-ssh-askpass abandonne et se termine. Une temporisation de « 0 » signifie que x11-ssh-askpass attend sans fin.
Par défaut « 0 ».

defaultXResolution (classe DefaultXResolution)
Nombre de pixels par unité de longueur pour les largeurs et les espacements horizontaux. Si la résolution horizontale (x) du serveur X est dans des proportions significatives plus grande ou plus petite que cette valeur, des parties de la boîte de dialogue sont étirées ou réduites horizontalement pour prendre en compte la différence. La valeur est un entier positif, suivi d’une barre (slash) « / », puis d’une abréviation d’unité sur un ou deux caractères. Les unités acceptées sont les pouces (in ou i) et les mètres (m).
Par défaut « 75/in » (75 pixels par pouce).

defaultYResolution (classe DefaultYResolution)
Nombre de pixels par unité de longueur pour les largeurs et les espacements verticaux. Si la résolution verticale (y) du serveur X est dans des proportions significatives plus grande ou plus petite que cette valeur, des parties de la boîte de dialogue sont étirées ou réduites verticalement pour prendre en compte la différence. Les valeurs acceptées sont identiques à celles décrites ci-avant.
Par défaut « 75/in » (75 pixels par pouce).

xResolutionFuzz (classe XResolutionFuzz)
Variation au-delà de laquelle on ne redimensionne pas horizontalement pour correspondre à la résolution horizontale réelle. Les résolutions acceptées sont les mêmes que pour defaultXResolution. Par exemple, si la résolution X est « 75/in » et la variation est « 50/in », les widgets ne seront redimensionnés horizontalement que si la résolution réelle est inférieure à 25 pixels par pouce ou supérieure à 125 pixels par pouce.
Par défaut « 20/in » (20 pixels par pouce).

yResolutionFuzz (classe YResolutionFuzz)
Variation au-delà de laquelle on ne redimensionne pas horizontalement pour correspondre à la résolution horizontale réelle. Les résolutions acceptées sont les mêmes que pour defaultXResolution.
Par défaut « 20/in » (20 pixels par pouce).

Les ressources suivantes sont reconnues par le widget « Dialog » :

title (classe Title)
Titre de l’application tel qu’il est spécifié au gestionnaire de fenêtres.

label (classe Label)
Ãtiquette affichée au-dessus des indicateurs en forme de diode.

font (classe Font)
Police de caractères utilisée pour afficher l’étiquette.

Les ressources suivantes sont reconnues par les widgets boîte de dialogue, bouton, indicateurs et le widget principal pour personnaliser l’apparence 3D (toutes les tailles sont en pixels) :

foreground (classe Foreground)
Couleur d’avant-plan du widget. C’est la couleur du texte pour les boutons et la boîte de dialogue, et la couleur de la diode active pour l’indicateur.

background (classe Background)
Couleur d’arrière-plan du widget. Pour l’indicateur, c’est la couleur de la diode inactive.

topShadowColor (classe TopShadowColor)
Couleur des bords du widget exposés à la lumière (haut et gauche).

bottomShadowColor (classe BottomShadowColor)
Couleur des bords du widget à l’ombre (bas et droite).

shadowThickness (classe ShadowTickness)
Ãpaisseur de la bordure 3D du widget.

borderColor (classe BorderColor)
Couleur de la bordure autour du widget.

borderWidth (classe BorderWidth)
Largeur de la bordure autour du widget.

horizontalSpacing (classe HorizontalSpacing)
Espacement sur la gauche et la droite du widget.

verticalSpacing (classe VerticalSpacing)
Espacement en haut et en bas du widget.

Les ressources suivantes sont reconnues par les widgets « indicateurs » :

minimumCount (classe MinimumCount)
Nombre minimal d’indicateurs à afficher dans la boîte de dialogue.

maximumCount (classe MaximumCount)
Nombre maximal d’indicateurs à afficher dans la boîte de dialogue.

Chaque bouton utilise les ressources suivantes pour personnaliser son étiquette :

label (classe Label)
Chaîne de caractères à afficher sur le bouton.

font (classe Font)
Police de caractères à appliquer à l’étiquette du bouton.

FICHIERS

VOIR AUSSI

X(1), ssh(1), ssh-agent(1)

Des morceaux de x11-ssh-askpass sont dérivés directement ou indirectement de morceaux de xscreensaver de Jamie Zawinski <jwz@jwz.org>, alors que d’autres sont des travaux originaux.

xscreensaver, Copyright © 1991-1999 Jamie Zawinski ⟨jwz@jwz.org⟩

Permission d’utiliser, copier, modifier, distribuer, et vendre ce logiciel et sa documentation dans n’importe quel but sans honoraires, à condition que le susdit avis de droit d’auteur apparaisse dans toutes les copies et que tant cet avis de droit d’auteur que cet avis de permission apparaissent dans la documentation l’accompagnant. Aucune représentation n’est faite de la pertinence de ce logiciel pour aucun but. On le fournit "tel quel" sans garantie expresse ou implicite.

Les morceaux restants sont sous les licence et copyright suivants :

x11-ssh-askpass par Jim Knoble ⟨jmknoble@pobox.com⟩ Copyright © 1999,2000,2001 Jim Knoble

Permission d’utiliser, copier, modifier, distribuer et vendre ce logiciel et sa documentation pour n’importe quel but sans honoraires, Ã condition que le susdit avis de droit d’auteur apparaisse dans toutes les copies et que tant cet avis de droit d’auteur que cet avis de permission apparaissent dans la documentation l’accompagnant.

(Ndt : Pour les textes originaux des licences et avis de copyright, se référer aux textes originaux des pages de manuel)

Laurent GAUTROT <l dot gautrot at free dot fr> 13/11/2002