PhenixID

PhenixID Test tool

Overview

This document describes how to use PhenixID test tool. PhenixID Test tool is included in PhenixID Multi-Factor Authentication (MFA). The Test tool could be used to verify RADIUS communication, smtp settings, LDAP settings, PhenixID Licenses etc.

Start PhenixID Test tool

  1. Open folder drive:\..\PhenixID\Server\bin
  2. Execute testtool.sh/testtool.bat

 

Using PhenixID Test tool

All results will be displayed in the text area on the right hand side of Test tool.

 

General tab

The general tab is used for checking the PhenixID license file and to test communication. Global http proxy settings will also be configured on this tab.

 

HTTP Proxy Settings

Setting Description Example
Proxy Host The dns name or ip address of your proxy server  192.168.8.20
Proxy Port The proxy port to be used  8080
Proxy User The username to be used for the proxy server, if any.  SrvProxy
Proxy Pwd The password for the user configured in previous comment P455w0rd
Show pwd Show password written in previous step.
Set proxy settings Configure Test tool to use the configured settings

 

Protocol Test

The protocol test section consist of two parts; HTTP and Telnet.

 

HTTP

Setting Description Example
Host The dns name or ip address to test https://msggweu.phenixidentity.com
Port The port to be used 443
Use proxy settings Tells Test tool to use proxy settings configured in previous step.
Send GET request Will send a http GET request to the host and port configured.

Telnet

Setting Description Example
Host The dns name or ip address to test msggweu.phenixidentity.com
Port The port to be used 443
Connect Will try a telnet connect to the host and port specified

License Check

The online license check will check the p12 license file and verify if it is valid.

Setting Description Example
License File The p12 license file to check license.p12
Keystore password Optional. Only to be configured if the p12 has been modified after receiving the file from PhenixID. EMPTY
Check License Will perform the license check

Example response from server when a valid license is checked:

License file for customer: <customername>

Allowed for continuous usage.

 

LDAP tab

The LDAP tab is for testing the LDAP connection, as well as the LDAP search filters.

 

LDAP Server Settings

Setting Description Example
IP Address The dns name or ip address of your LDAP server  192.168.8.20
Port The LDAP port to be used  636
SSL If an encrypted connection with the LDAP server should be used TRUE
Admin DN The distinguished name for the proxy account to be used cn=administrator,cn=users,dc=company,dc=local
Password Password for the proxy account  TopSecret
Show pwd Show password written in previous step.
Test LDAP connection Will do an LDAP Bind, using the parameters configured

 

Search Settings

Setting Description Example
Search base The DN used as base when searching dc=company,dc=local
LDAP filter The LDAP filter used when searching  (&(sAMAccountName=JDoe)(mobile=*))
Attributes MANDATORY. Attributes to fetch from the LDAP object(s) matching the configured filter mobile,mail,cn
Search scope Search scope to be used (BASE, ONE, SUB) SUB
Test LDAP search Will do an LDAP Search, using the parameters configured in LDAP Server settings and Search Settings

 

SMS / SMTP

The SMS / SMTP tab is used to test and verify communication with PhenixID Message Gateway and the SMTP server used. The proxy server will be used if configured on the general tab.

 

PhenixID Message Gateway Settings

Setting Description Example
URL The URL to PhenixID Message Gateway https://msggweu.phenixidentity.com/phenixidsms/phenixidsms
Username The username used for authentication to PhenixID Message Gateway, received from PhenixID.  CustomerID
Password The Password received from PhenixID.  Toptopsecret
Show pwd Display the value
Authenticate Will test to authenticate to the service with the parameters configured. 0 : OK – If working as desired
Mobile Mobile phone number to be used for testing the SMS service +4670121212
Send SMS Will test to send a SMS to the mobile number provided using the parameters configured. SMS Text: Test Message
Send Voice Will test to send a Voice message to the mobile number provided using the parameters configured. Voice Message: 1 2 3 4

SMTP Settings

Setting Description Example
SMTP Host The dns name or ip address of your SMTP server 127.0.0.1
SMTP Port The port used by the SMTP service 25
User name The user name for authentication. Only if authenticated relay is used
Password The password for authentication. Only if authenticated relay is used
Show pwd Display the value
Start TLS
SSL on connect
Check server identity Check if server name is matching the cn from the certificate
From The sender e-mail address  donald.duck@company.org
To The recipient e-mail address  mickey.mouse@company.org
Send Mail Sends the mail Subject: Test mail subject

 

RADIUS

The RADIUS tab is used to test communication with the RADIUS server.

 

Server Settings

Configure Test tool to communicate with the RADIUS server

Setting Description Example
IP Address The dns name or ip address of your RADIUS server  192.168.8.20
Port The RADIUS port to be used  1812
Secret The RADIUS pre shared key configured on your RADIUS server ToPSecreTT
Show secret Display the value
Timeout Number of seconds before timing out 5

 

Client Settings

Configure the “client parameters” that Test tool should send to the RADIUS server

Setting Description Example
User name User name to send to RADIUS server JDoe
Password Password for username previously entered  TopSecre
Show pwd Display the value
OTP The OTP, either received through SMS/SMTP or generated using token
State The state, returned from the RADIUS server
RADIUS Attributes Displays a list of the additional RADIUS attributes to be sent to the server. Use the “Add” and “Remove attribute” buttons to modify the list. 44: SMS

 

Legacy API

This panel is used when testing the functionality of the “Legacy API”.

 

Server Settings

Setting Description Example
IP Address The dns name or ip address of your legacy API server  192.168.8.20
Port The Legacy API port to be used, default is 3100  3100
Client name The Legacy API client name that will be used for name mapping in configuration PSS
Encrypt data If encryption is used or not.

 

Communication

Select desired Command to send to the Legacy API. Additional configuration might be necessary depending on selected command to use.

 

About

Information about version of PhenixID Test tool and link to this documentation.


DISCLAIMER
Information provided in this document is for your information only. PhenixID makes no explicit or implied claims to the validity of this information. Any trademarks referenced in this document are the property of their respective owners.

The origin of this information may be internal or external to PhenixID. PhenixID makes all reasonable efforts to verify this information.

PhenixID - support.phenixid.se