sipsak - En ligne dans le Cloud

PROGRAMME:

Nom

sipsak - un utilitaire pour divers tests sur les serveurs sip et les agents utilisateurs

SYNOPSIS

sipsak [-dFGhiILnNMRSTUVvwz] [-une MOT DE PASSE ] [-b NUMÉRO ] [-c SIPURI ] [-C SIPURI ] [-RÉ
NUMÉRO ] [-e NUMÉRO ] [-E STRING ] [-F DOSSIER ] [-g STRING ] [-H HOSTNAME ] [-l PORT ] [-m
NUMÉRO ] [-ou NUMÉRO ] [-p HOSTNAME ] [-P NUMÉRO ] [-q REGEXP ] [-r PORT ] [-t NUMÉRO ] [-tu
STRING ] [-W NUMÉRO ] [-X NUMÉRO ] -s SIPURI

DESCRIPTION

sipsak est un utilitaire de diagnostic et de stress SIP. Il envoie des requêtes SIP au serveur
au sein du siroter-uri et examine les réponses reçues. Il fonctionne dans l'un des
modes :

- mode par défaut
Un message SIP est envoyé à destination dans siroter-uri et l'état de la réponse s'affiche. Les
la demande est soit tirée de nom de fichier ou généré en tant que nouveau message OPTIONS.

- mode traceroute (-T)
Ce mode est utile pour apprendre le chemin de la requête. Il fonctionne de manière similaire à la couche IP
utilitaire traceroute (8).

- mode message (-M)
Envoie un message court (similaire aux SMS des téléphones portables) à une cible donnée.
Avec la possibilité -B le contenu du MESSAGE peut être réglé. Utile pourrait être le
Options -c et -O dans ce mode.

- mode usrloc (-U)
Mode stress pour le registraire SIP. sipsak continue de s'inscrire sur un serveur SIP à un niveau élevé
rythme. De plus, le registraire peut être stressé avec le -I ou la -M option. Si
-I et -M sont omis sipsak peut être utilisé pour enregistrer un contact donné (avec le -C
option) pour un compte chez un registraire et pour interroger les liaisons actuelles pour un
compte chez un registraire.

- mode randtrash (-R)
Mode de torture de l'analyseur. sipsak continue d'envoyer des messages corrompus au hasard pour torturer un
L'analyseur du serveur SIP.

- mode inondation (-F)
Mode stress pour les serveurs SIP. sipsak continue d'envoyer des requêtes à un serveur SIP à un niveau élevé
rythme.

Si libruli (http://www.nongnu.org/ruli/) le support est compilé dans le sipsak binaire, alors
d'abord, une recherche SRV pour _sip._udp.hostname est effectuée. Et si cette recherche échoue un A normal
la recherche est faite. Si un port a été indiqué dans l'URI cible, la recherche SRV est omise. Basculement,
la distribution de charge et d'autres transports ne sont pas encore pris en charge.

OPTIONS

-a, --password MOT DE PASSE
Avec le donné MOT DE PASSE une authentification sera tentée sur le '401 reçu
Non autorisé'. L'autorisation sera essayée à temps. Si cette option est omise, un
l'autorisation avec un mot de passe vide ("") sera tentée. Si le mot de passe est égal
à - le mot de passe sera lu à partir de l'entrée standard (par exemple le clavier). Cette
empêche les autres utilisateurs sur le même hôte de voir le mot de passe le mot de passe dans le
liste des processus. NOTE: le mot de passe peut toujours être lu dans la mémoire si d'autres utilisateurs
y avoir accès.

-A, --timing
imprime uniquement les valeurs de synchronisation de l'exécution du test si la verbosité est égale à zéro car aucun -v
a été donné. Si un ou plusieurs -v ont reçu cette option sera ignorée.

-b, --apendix-begin NOMBRE
Le numéro de départ qui est ajouté au nom d'utilisateur en mode usrloc. Cette
NUMÉRO est augmenté jusqu'à ce qu'il atteigne la valeur donnée par le -e paramètre. Si
omis, le numéro de départ sera un.

-B, --message-body CHAÎNE
Le donné STRING sera utilisé comme corps pour les requêtes MESSAGE sortantes.

-c, --de SIPURI
Le donné SIPURI sera utilisé dans l'en-tête De si sipsak fonctionne en mode message
(initié avec le -M option). Ceci est utile pour présenter le récepteur d'un
MESSAGE une adresse significative et utilisable à laquelle peut-être même des réponses peuvent être envoyées.

-C, --contacter SIPURI
C'est le contenu de l'en-tête Contact en mode usrloc. Cela permet d'insérer
en avant comme pour le courrier. Par exemple vous pouvez insérer l'uri de votre premier SIP
compte sur un deuxième compte, ainsi tous les appels vers le deuxième compte seront transférés
au premier compte. Comme l'argument de cette option ne sera pas inclus dans
parenthèses, vous pouvez également donner plusieurs contacts au format brut séparés par des virgules
liste. Les mots spéciaux vide or aucun n'entraînera aucun en-tête de contact dans le
REGISTER demande et donc le serveur doit répondre avec les liaisons actuelles pour
le compte chez le registraire.

-d, --ignore-redirections
Si cette option est définie, toutes les redirections seront ignorées. Par défaut sans cette option
les redirections reçues seront respectées. Cette option est automatiquement activée dans le
mode randtrash et en mode inondation.

-D, --timeout-factor NOMBRE
Le temporisateur SIP_T1 est multiplié par le NOMBRE donné. Après avoir reçu un
réponse provisoire pour une requête INVITE, ou lorsqu'un transport fiable comme TCP
ou TLS est utilisé sipsak attend le temps résultant pour une réponse finale
jusqu'à ce qu'il abandonne.

-e, --appendix-end NOMBRE
Le numéro de fin qui est ajouté au nom d'utilisateur en mode usrloc. Cette
nombre est augmenté jusqu'à ce qu'il atteigne cette fin . En mode inondation, c'est
le nombre maximum de messages qui seront envoyés. S'il est omis, la valeur par défaut est
2^31 (2147483647) en mode inondation.

-E, --transport CHAÎNE
La valeur de STRING sera utilisé comme transport IP pour envoyer et recevoir des demandes
et réponses. Cette option écrase tout résultat de l'évaluation URI et SRV
chercher. Actuellement, seuls 'udp' et 'tcp' sont acceptés comme valeur pour CHAÎNE DE CARACTÈRES.

-f, --filename FICHIER
Le contenu de DOSSIER sera lu en mode binaire et sera utilisé en remplacement
pour le message sip créé alternativement. Cela peut être utilisé dans le mode par défaut pour
faire d'autres requêtes que les requêtes OPTIONS (par exemple INVITE). Par défaut manquant
des retours chariot devant les sauts de ligne seront insérés (utilisez -L pour désactiver
cette fonction). Si le nom de fichier est égal à - le fichier est lu depuis l'entrée standard,
par exemple à partir du clavier ou d'un tuyau. Veuillez noter que les fonctions de manipulation
(par exemple l'insertion d'un en-tête Via) ne sont testés qu'avec des requêtes conformes RFC. En plus
les chaînes spéciales dans le fichier peuvent être remplacées par des valeurs locales ou données
(voir -g et -G pour plus de détails).

-F, --mode-inondation
Cette option active le mode inondation. Dans ce mode, les requêtes OPTIONS avec
des nombres CSeq croissants sont envoyés au serveur. Les réponses sont ignorées -- port source
9 (jeter) de localhost est annoncé dans la plus haute Via.

-h, --aide
Imprime un message d'aide à l'utilisation simple. Si l'option longue --Aidez-moi est disponible il
imprimera un message d'aide avec les options longues disponibles.

-g, --replace-string CHAÎNE
Active le remplacement de $replace$ dans la requête (généralement lu à partir d'un
fichier) avec le CHAÎNE DE CARACTÈRES. Alternativement, vous pouvez également spécifier une liste d'attributs et
valeurs. Cette liste doit commencer et se terminer par un caractère non alphanumérique. Les
le même caractère doit également être utilisé comme séparateur entre l'attribut et la valeur
et entre de nouvelles paires de valeurs d'attribut supplémentaires. La chaîne "$attribut$" sera
remplacé par la chaîne de valeur dans le message.

-G, --remplacer
Active le remplacement automatique des variables suivantes dans la requête
(généralement lu à partir d'un fichier) : $dsthost$ sera remplacé par l'hôte ou
nom de domaine qui est donné par le -s paramètre. $srhost$ sera remplacé par le
nom d'hôte de la machine locale. $port$ sera remplacé par le port d'écoute local
of sipsak. $utilisateur$ sera remplacé par le nom d'utilisateur qui est donné par le -s
paramètre.

-H, --hostname NOM D'HÔTE
Remplace la détection automatique du nom d'hôte par le paramètre donné.
Mise en garde: utilisez-le avec prudence (de préférence uniquement si la détection automatique échoue).

-i, --no-via
Désactive l'insertion de la ligne Via du localhost. Mise en garde: ceci probablement
désactive la réception des réponses du serveur.

-I, --invite-mode
Active les cycles d'invitation dans le mode usrloc. Il doit être combiné avec -OU.
Dans cette combinaison sipsak enregistre d'abord un utilisateur, puis simule un
invitation à cet utilisateur. D'abord une invitation est envoyée, ceci est répondu avec 200 OK et
enfin un ACK est envoyé. Cette option peut également être utilisée sans -U , mais vous devriez être
assurez-vous de ne PAS inviter de vrais UA avec cette option. En cas de disparition -U le -l
PORT est obligatoire car ce n'est que si vous avez fait un -U exécuter avec un port local fixe avant,
une course avec -I et le même port local fixe peut réussir. Mise en garde: sipsak is
l'absence de véritable UA et les invitations à de vrais UA peuvent entraîner un comportement inattendu.

-j, --headers CHAINE
Le manuel de formation un magnifique sera ajouté comme un ou plusieurs en-têtes supplémentaires à la demande. Les
la chaîne "\n" (note : deux caractères) sera remplacée par CRLF et entraînera ainsi
deux en-têtes séparés. De cette façon, plus d'un en-tête peut être ajouté.

-l, --local-port PORT
Le socket UDP de réception utilisera le réseau local Port. Utile si un fichier est
donné par -f qui contient une ligne Via correcte. Vérifier la -S option pour plus de détails comment
sipsak envoie et reçoit des messages.

-L, --no-crlf
Désactive l'insertion des retours chariot (\r) avant tous les sauts de ligne (\n)
(ce qui n'est pas déjà effectué par retour chariot) si l'entrée provient d'un
déposer ( -f ). Sans cette option, une ligne vide sera également ajoutée à la demande
si nécessaire.

-m, --max-forwards NOMBRE
Cela définit la valeur du champ d'en-tête Max-Forward. Si omis pas de Max-Forward
champ sera inséré. Si omis dans le mode traceroute nombre aura 255 ans.

-M, --mode-message
Cela active les cycles de messages dans le mode usrloc (connu de sipsak
versions antérieures à la 0.8.0 dans le test usrloc normal). Cette option doit être combinée
avec -U afin qu'un enregistrement réussi soit testé avec un message de test au
utilisateur et a répondu avec 200 OK. Mais cette option peut également être utilisée sans le -U
option. Mise en garde: utiliser sans -U peut provoquer un comportement inattendu.

-n, --numérique
Au lieu du nom de domaine complet dans la ligne Via, l'adresse IP de l'hôte local
sera utilisé. Cette option est maintenant activée par défaut.

-N, --nagios-code
Utilisez les codes de retour compatibles Nagios au lieu des codes sipsak normaux. Ça signifie
sipsak retournera 0 si tout s'est bien passé et 2 en cas d'erreur (locale ou
à distance).

-o, --sleep NUMÉRO
sipsak dormira pour NUMÉRO ms avant de démarrer le cycle suivant en mode usrloc.
Cela ralentira tout le processus de test pour être plus réaliste. Chaque cycle sera
encore terminé aussi vite que possible, mais l'ensemble du test sera ralenti.

-O, --disposition CHAÎNE
Le donné STRING sera utilisé comme contenu pour l'en-tête Content-Disposition.
Sans cette option, il n'y aura pas d'en-tête Content-Disposition dans la demande.

-p, --outbound-proxy NOM D'HÔTE[:PORT]
l'adresse du nom d'hôte est la cible vers laquelle la requête sera envoyée
(mandataire sortant). Utilisez ceci si l'hôte de destination est différent de la partie hôte
de la requête uri. Le nom d'hôte est résolu via DNS SRV s'il est pris en charge (voir
description pour la résolution SRV) et aucun port n'est fourni.

-P, --processus NOMBRE
Start NUMÉRO de processus en parallèle pour effectuer la vérification des envois et des réponses. Fait seulement
si un nombre plus élevé pour -e est donné en mode usrloc, message ou invite.

-q, --search REGEXP
faire correspondre les réponses avec REGEXP et renvoie false si aucune correspondance n'a eu lieu. Utile pour
exemple pour détecter le nom du serveur dans le champ d'en-tête du serveur.

-r, --port-port distant
Au lieu du port SIP par défaut 5060, le PORT sera utilisé. Alternativement le
le port distant peut être donné dans le sip uri du -s paramètre.

-R, --mode aléatoire
Cela active le mode randtrash. Dans ce mode, les requêtes OPTIONS seront envoyées à
serveur avec un nombre croissant de caractères bloqués au hasard dans cette requête.
La position dans la requête et le caractère de remplacement sont choisis au hasard.
Toute autre réponse que Bad request (4xx) arrêtera ce mode. aussi trois
les envois sans réponse arrêteront ce mode. Avec le -t paramètre le maximum de poubelle
des caractères peuvent être donnés.

-s, --sip-uri SIPURI
Cette option obligatoire définit la destination de la demande. ça dépend du mode
si seul le nom du serveur ou également un nom d'utilisateur est obligatoire. Exemple pour un plein
SIPURI : siroter:[email protected]: 123 Voir la note dans la partie description sur SRV
recherche des détails sur la façon dont le nom d'hôte de cet URI est converti en une adresse IP et un port.

-S, --symétrique
Avec cette option sipsak n'utilisera qu'un seul port pour envoyer et recevoir des messages.
Avec cette option, le port local pour l'envoi sera la valeur du -l option.
En mode par défaut sipsak envoie depuis un port aléatoire et écoute sur le port donné
du -l option. Remarque: Avec cette option sipsak ne pourra pas recevoir
réponses des serveurs avec signalisation asymétrique (et implémentation de rapport cassée)
comme le proxy Cisco. Si tu cours sipsak en tant que root et avec prise en charge des sockets bruts (vérifiez
la sortie du -V option) alors cette option n'est pas requise car dans cette
maisons sipsak utilise déjà un seul port pour envoyer et recevoir des messages.

-t, --trash-chars NOMBRE
Ce paramètre spécifie le maximum de caractères supprimés en mode randtrash.
Si omis NUMÉRO sera fixé à la longueur de la demande.

-T, --mode-traceroute
Cela active le mode traceroute. Ce mode fonctionne comme le bien connu
traceroute(8) la commande s'attend à ce que le nombre de sauts de réseau ne soit pas compté plutôt
le nombre de serveur sur le chemin de l'utilisateur de destination. Aussi le temps aller-retour
de chaque demande est imprimée, mais en raison d'une limitation dans le protocole sip, le
l'identité (IP ou nom) ne peut être déterminée et imprimée que si la réponse du
serveur contient un champ d'en-tête d'avertissement. Dans ce mode à chaque demande sortante le
la valeur du champ d'en-tête Max-Forwards est augmentée, en commençant par un. Le maximum
de l'en-tête Max-Forwards sera 255 si aucune autre valeur n'est donnée par le -m paramètre.
Toute autre réponse que 483 ou 1xx est traitée comme une réponse finale et sera
mettre fin à ce mode.

-u, --auth-username CHAINE
Utiliser le donné STRING comme valeur de nom d'utilisateur pour l'authentification (compte différent
et nom d'utilisateur d'authentification).

-U, --usrloc-mode
Cela active le mode usrloc. Sans le -I ou la -M option, ceci seulement
enregistre les utilisateurs auprès d'un bureau d'enregistrement. Avec l'une des options ci-dessus, la précédente
l'utilisateur enregistré sera également sondé avec un flux d'appels simulé (invite, 200,
ack) ou avec un message instantané (message, 200). Un mot de passe pour tous les comptes d'utilisateurs
dans le test usrloc peut être donné avec le -a option. Un nom d'utilisateur est obligatoire
pour ce mode dans le -s paramètre. Le nombre à partir du -b paramètre à la
-e paramètre est ajouté le nom d'utilisateur. Si la -b et la -e paramètre sont omis,
un seul s'exécute avec le nom d'utilisateur donné, mais sans ajouter de numéro aux noms d'utilisateur
est fait.

-v, --verbeux
Ce paramètre augmente la verbosité de la sortie. Non -v signifie presque pas de sortie sauf
dans traceroute et les messages d'erreur. Le maximum de trois v imprime le contenu
de tous les paquets reçus et envoyés.

-V, --version
Imprime le nom et le numéro de version de sipsak et les options qui ont été
compilé dans le binaire.

-w, --extract-ip
Active l'extraction de l'IP ou du nom d'hôte du champ d'en-tête Warning.

-W, --nagios-warn NUMÉRO
Retour Nagios avertir le code de sortie (1) si le nombre de retransmissions avant le succès
était au-dessus du nombre donné.

-x, --expires NOMBRE
Définit la valeur de l'en-tête Expires sur le nombre donné.

-z, --remove-bindings
Active la suppression aléatoire des anciennes liaisons en mode usrloc. Combien par
cent des liaisons seront supprimés, est déterminé par le USRLOC_REMOVE_PERCENT
définir dans le code (définir avant la compilation). Suppression multiple des reliures
est possible et ne peut être empêché.

RETOUR VALEURS

La valeur de retour 0 signifie qu'un 200 a été reçu. 1 signifie autre chose que 1xx ou 2xx
a été reçu. 2 sera renvoyé en cas d'erreurs locales telles que des noms non résolvables ou erronés
combinaison d'options. 3 sera retourné sur les erreurs distantes comme les erreurs de socket (par exemple icmp
erreur), redirige sans en-tête de contact ou simplement pas de réponse (timeout).

Si la -N option a été donnée le code de retour sera 2 dans le cas de n'importe quel (local ou distant)
Erreur. 1 au cas où il y aurait eu des retransmissions de sipsak au serveur. Et 0 s'il y a
n'y avait aucune erreur.

ATTENTION

Utilisez le sipsak de manière responsable. L'exécuter dans l'un des modes de stress impose un fardeau substantiel sur
réseau et serveur testés.

EXEMPLES

sipsak -vv -s sip :[email protected]
affiche les réponses reçues.

sipsak -T -s sip :[email protected]
trace le chemin SIP vers personne.

sipsak -U -C sip:me@home -x 3600 -a mot de passe -s sip:myself@company
encarts transfert du travail à la maison pendant une heure.

sipsak -f bye.sip -g '!FTAG!345.af23!TTAG!1208.12!' -s sip:myproxy
lit le fichier bye.sip, remplace $FTAG$ par 345.af23 et $TTAG$ par 1208.12 et
enfin envoyer ce message à myproxy

LIMITATIONS / ne pas MIS EN ŒUVRE

De nombreux serveurs peuvent décider de NE PAS inclure les champs d'en-tête SIP "Warning". Malheureusement, ce
rend impossible l'affichage des adresses IP des serveurs SIP en mode traceroute.

IPv6 n'est pas pris en charge.

Prise en charge manquante pour l'en-tête Record-Route et Route.

Utilisez sipsak en ligne en utilisant les services onworks.net