# Jakarta Authentication Technology Compatibility Kit, Version 2.0
Release Notes, September 2020

## Kit Contents

The Jakarta Authentication, Version 2.0 Technology Compatibility Kit (TCK) includes the following items:

- Jakarta Authentication TCK tests for signature, API, and End-to-End tests:

- A signature test checks that all of the public APIs are supported in the Jakarta Authentication Version 2.0 implementation that is being tested

- API tests for all of the public APIs under the `jakarta.security.auth.message` package

- End-To-End tests that demonstrate compliance with the Jakarta Authentication 2.0 Specification

## Platform Notes

The Jakarta Authentication TCK tests have been built and tested with JavaTM Platform, Standard Edition 8 (Java SE 8).

The Jakarta Authentication TCK tests have been run on the following platforms:

- MAC OS X, El Capitan (10.9.5+)
- Oracle Linux 7.1
- Windows 10
- Alpine Linux v3.12

The Jakarta Authentication TCK tests have been run against the Jakarta Authentication 2.0 Compatible Implementation, Eclipse GlassFish 6.0.

## Installing, Setting Up, and Running the Jakarta Authentication TCK

Refer to the Jakarta Authentication TCK 2.0 User's Guide for complete instructions on installing, setting up, and running the Jakarta Authentication TCK. The online version of the JT Harness version 5.0 documentation is available here.

## Jakarta Authentication TCK Requirements, Facts, and Figures

> The Jakarta Authentication TCK requires a minimum of 77 MB of free disk space:

> - Jakarta Authentication TCK (zipped): 18 MB
> - Jakarta Authentication TCK (unzipped): 57 MB
> - Space for Jakarta Authentication log/report files: 2 MB minimum (trace off)

> The test suite bundle contains the following:

> - EARs: 11
> - JARs: 35
> - WARs: 8
> - Total tests: 88
>   - Baseline: 7
>   - Servlet Profile: 42
>   - Soap Profile (includes authstatus): 39

> There are multiple levels of compliance available for Jakarta Authentication certification. Jakarta Authentication allows for certification of the following profiles: Baseline, Servlet Profile, SOAP Profile. Baseline compliance is the most basic level of Jakarta Authentication certification. Servlet Profile compliance also requires Baseline compliance while SOAP assumes Servlet and Baseline.

## Status Information

### Exclude List

> You can find the exclude list in the Jakarta Authentication bundle in `<TS_HOME>/bin/ts.jtx`. New Exclude lists will be released in revised versions of this TCK. Information about updates will be provided through the Jakarta Authentication specification web site: https://jakarta.ee/specifications/authentication/2.0/

## Known Problems and Workarounds

### Running the Jakarta Authentication TCK Against Jakarta EE CI on Windows

> When configuring and running the TCK against the CI (e.g. Eclipse GlassFish 6.0) on Windows, please make sure to install all related software (Java SE, the Jakarta Authentication CI, TCK, etc.) on the same drive (for example, `C:`). If you want to install on a drive other than `C:`, please be sure to change the following properties in `<TS_HOME>/bin/ts.jte:`

>     ri.applicationRoot=c:
>     s1as.applicationRoot=c:

## Attributions

> The Jakarta Authentication Specification TCK test suite includes software developed by the Apache Software Foundation (http://www.apache.org/), the dom4j Project (http://sourceforge.net/projects/dom4j/), and the JDOMTM Project (http://www.jdom.org/). The Apache Ant Contrib project is located at http://ant-contrib.sourceforge.net/.