Skip to main content

Redfish Service Validator

Project description

Copyright 2017-2022 DMTF. All rights reserved.

Redfish Service Validator

About

The Redfish Service Validator is a Python3 tool for checking conformance of any "device" with a Redfish interface against Redfish CSDL schema. The tool is designed to be device-agnostic and is driven based on the Redfish specifications and schema intended to be supported by the device.

Installation

From PyPI:

pip install redfish_service_validator

From GitHub:

git clone https://github.com/DMTF/Redfish-Service-Validator.git
cd Redfish-Service-Validator
python setup.py sdist
pip install dist/redfish_service_validator-x.x.x.tar.gz

Requirements

External modules:

You may install the prerequisites by running:

pip3 install -r requirements.txt

If you have a previous beautifulsoup4 installation, use the following command:

pip3 install beautifulsoup4 --upgrade

There is no dependency based on Windows or Linux OS. The result logs are generated in HTML format and an appropriate browser, such as Chrome, Firefox, or Edge, is required to view the logs on the client system.

Usage

Example usage without providing a configuration file:

rf_service_validator -u root -p root -r https://192.168.1.1

Example usage with a configuration file:

rf_service_validator -c config/example.ini

The following sections describe the arguments and configuration file options. The file config/example.ini can be used as a template configuration file. At a minimum, the ip, username, and password options must be modified.

[Tool]

Variable CLI Argument Type Definition
verbose -v integer Verbosity of tool in stdout

[Host]

Variable CLI Argument Type Definition
ip -r string The address of the Redfish service (with scheme); example: 'https://123.45.6.7:8000'
username -u string The username for authentication
password -p string The password for authentication
description --description string The description of the system for identifying logs; if none is given, a value is produced from information in the service root
forceauth --forceauth boolean Force authentication on unsecure connections
authtype --authtype string Authorization type; 'None', 'Basic', 'Session', or 'Token'
token --token string Token when 'authtype' is 'Token'
ext_http_proxy --ext_http_proxy string URL of the HTTP proxy for accessing external sites
ext_https_proxy --ext_https_proxy string URL of the HTTPS proxy for accessing external sites
serv_http_proxy --serv_http_proxy string URL of the HTTP proxy for accessing the service
serv_https_proxy --serv_https_proxy string URL of the HTTPS proxy for accessing the service

[Validator]

Variable CLI Argument Type Definition
payload --payload string The mode to validate payloads ('Tree', 'Single', 'SingleFile', or 'TreeFile') followed by resource/filepath; see below
logdir --logdir string The directory for generated report files; default: 'logs'
oemcheck --nooemcheck boolean Whether to check OEM items on service
uricheck --uricheck boolean Allow URI checking on services below RedfishVersion 1.6.0
debugging --debugging boolean Output debug statements to text log, otherwise it only uses INFO
schema_directory --schema_directory string Directory for local schema files
mockup --mockup string Enables insertion of local mockup resources to replace missing, incomplete, or incorrect implementations retrieved from the service that may hinder full validation coverage

Payload Option

The payload option takes two parameters as strings.

The first parameter specifies how to test the payload URI given, which can be 'Single', 'SingleFile', 'Tree', or 'TreeFile'. 'Single' and 'SingleFile' will test and give a report on a single resource. 'Tree' and 'TreeFile' will test and give a report on the resource and every link from that resource.

The second parameter specifies a URI of the target payload to test or a filename of a local file to test.

For example, --payload Single /redfish/v1/AccountService will perform validation of the URI /redfish/v1/AccountService and no other resources.

Execution Flow

  1. The Redfish Service Validator starts by querying the service root resource from the target service and collections information about the service.
    • Collects all CSDL from the service.
  2. For each resource found, it performs the following:
    • Reads all the URIs referenced in the resource.
    • Reads the schema file related to the particular resource and builds a model of expected properties.
    • Tests each property in the resource against the model built from the schema.
  3. Step 2 repeats until all resources are covered.

When validating a resource, the following types of tests may occur for each property:

  • Verify @odata properties against known patterns, such as @odata.id.
  • Check if the property is defined in the resource's schema.
  • Check if the value of the property matches the expected type, such as integer, string, boolean, array, or object.
  • Check if the property is mandatory.
  • Check if the property is allowed to be null.
  • For string properties with a regular expression, check if the value passes the regular expression.
  • For enumerations, check if the value is within the enumeration list.
  • For numeric properties with defined ranges, check if the value is within the specified range.
  • For object properties, check the properties inside the object againt the object's schema definition.
  • For links, check that the URI referenced matches the expected resource type.

Conformance Logs - Summary and Detailed Conformance Report

The Redfish Service Validator generates an HTML report under the 'logs' folder and is named as 'ConformanceHtmlLog_MM_DD_YYYY_HHMMSS.html', along with a text and config file. The report gives the detailed view of the individual properties checked, with pass, fail, skip, or warning status for each resource checked for conformance.

Additionally, there is a verbose text log file that may be referenced to diagnose tool or schema problems when the HTML log is insufficient.

The Test Status

The test result for each GET operation will be reported as follows:

  • PASS: If the operation is successful and returns a success code, such as 200 OK.
  • FAIL: If the operation failed for reasons mentioned in GET method execution, or some configuration.
  • SKIP: If the property or method being checked is not mandatory is not supported by the service.

Limitations

The Redfish Service Validator only performs GET operations on the service. Below are certain items that are not in scope for the tool.

  • Other HTTP methods, such as PATCH, are not covered.
  • Wuery parameters, such as $top and $skip, are not covered.
  • Multiple services are not tested simultaneously.

Building a Standalone Windows Executable

The module pyinstaller is used to package the environment as a standlone executable file; this can be installed with the following command:

pip3 install pyinstaller

From a Windows system, the following command can be used to build a Windows executable file named RedfishServiceValidator.exe, which will be found in dist folder:

pyinstaller -F -w -i redfish.ico -n RedfishServiceValidator.exe RedfishServiceValidatorGui.py

Release Process

  1. Go to the "Actions" page
  2. Select the "Release and Publish" workflow
  3. Click "Run workflow"
  4. Fill out the form
  5. Click "Run workflow"

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

redfish_service_validator-2.3.0.tar.gz (75.5 kB view hashes)

Uploaded Source

Built Distribution

redfish_service_validator-2.3.0-py3-none-any.whl (78.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page