# fido2-tests

**Repository Path**: 3DA502/fido2-tests

## Basic Information

- **Project Name**: fido2-tests
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-03
- **Last Updated**: 2024-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# fido2-tests

Test suite for FIDO2, U2F, and other security key functions

# Setup

Need python 3.6+.

`make venv` and `source venv/bin/activate`

Or simply `pip3 install --user -r requirements.txt`

# Running the tests

Run all FIDO2, U2F, and HID tests:

```
pytest tests/standard -s
```

Run vendor/model specific tests:

```
pytest tests/vendor -s
```

Run subset of tests with `-k` flag, example:
```
pytest -k "getinfo or hmac_secret" -s
```

To run tests via nfc, supply the `--nfc` option.
Make sure that you have `pyscard` python module installed properly and have updated `python-fido2` (by Yubikey) library to lastest version

```
pytest --nfc tests/standard -s
```

Note that in most cases when testing a hardware authenticator, `-s` must be supplied to disable stdin/stdout capturing.  This is so the prompts to power cycle the authenticator can be seen and continued.

# Running against simulation

To run tests against a "simulation" build of the Solo authenticator, supply the `--sim` option.

```
pytest --sim tests/standard
```

All tests should pass without having to use `-s` or provide any interaction.

# Notes

Initial SoloKeys models truncates the displayName, which causes a couple of the tests to fail.
To succeed all tests, pass `--vendor solokeys` as an option.

# Contributing

We use `black` and `isort` to prevent code formatting discussions.

The `make venv` setup method installs git pre-commit hooks that check conformance automatically.

You can also `make check` and `make fix` manually, or use an editor plugins.

# License

Apache-2.0 OR MIT