# Jakarta EE Authentication Technology Compatibility Kit, Version 2.0

## Release Notes, May 2021

## Kit Contents

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

- Jakarta EE 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 EE 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 EE Authentication 2.0 Specification

## Platform Notes

The Jakarta EE Authentication TCK tests have been built with JDK 8 (1.8) and tested with JDK 8 and 11.

The Jakarta EE 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 EE Authentication TCK tests have been run against the Jakarta Authentication 2.0 Compatible Implementation, Eclipse GlassFish 6.0 and 6.1.

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

Refer to the Jakarta EE Authentication TCK 2.0 User's Guide (HTML, PDF) 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 EE Authentication TCK Requirements, Facts, and Figures

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

> - Jakarta EE Authentication TCK (zipped): 18 MB
> - Jakarta EE Authentication TCK (unzipped): 57 MB
> - Space for Jakarta EE 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 EE Authentication certification. Jakarta EE Authentication allows for certification of the following profiles: Baseline, Servlet Profile, SOAP Profile. Baseline compliance is the most basic level of Jakarta EE 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 EE 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 a compatible implementation (e.g. Eclipse GlassFish 6.0 or 6.1) on Windows, please make sure to install all related software (Java SE, the Jakarta Authentication compatible implementation, the 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 EE 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/.