Skip to content

Commit

Permalink
Merge pull request #20 from wbcsd/update-readme
Browse files Browse the repository at this point in the history
docs: update version and endpoint list
  • Loading branch information
zeitgeist authored Mar 28, 2024
2 parents 547a658 + a02f64e commit 80ba2d4
Show file tree
Hide file tree
Showing 3 changed files with 12 additions and 6 deletions.
16 changes: 10 additions & 6 deletions endpoint/README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# Endpoint implementation of Technical Specifications for PCF Data Exchange (Version 2.0.0)
# Endpoint implementation of Technical Specifications for PCF Data Exchange (Version 2.1.0)

A yet incomplete beta-quality implementation of the HTTP REST API of the [Technical Specifications for PCF Data Exchange](https://wbcsd.github.io/tr/2023/data-exchange-protocol-20230221/)

## Status

⚠️⚠️⚠️⚠️⚠️
⚠️⚠️⚠️⚠️⚠️
**This is **not** a "reference implementation" but a demonstrator used to generate OpenAPI spec files for documenting the Spec's REST API. A thorough review WRT specification compliance is still pending.**

**This means, you should not yet rely on this implementation for conducting conformance testing, yet.**
**This means, you should not yet rely on this implementation for conducting conformance testing, yet.**
⚠️⚠️⚠️⚠️⚠️

For details on the backlog, please see [BACKLOG.md](BACKLOG.md).
Expand All @@ -22,8 +22,12 @@ The following endpoints are available:
- `/2/events` implementing the `Events` action
- `/2/auth/token` implementing `Authenticate` action
- Additional endpoints are:
- `/2/.well-known/openid-configuration`: OpenId provider configuration document
- `/2/jwks`: the JSON Web Key Set used to encode and sign the authentication token
- `/openapi.json`: OpenAPI description file which is automatically generated from the types defined in [`api_types.rs`](src/api_types.rs) and endpoints defined in [`main.rs`](src/main.rs)
- Swagger UI: `/swagger-ui/` if you fancy a visualization
- Swagger UI: `/swagger-ui/` if you fancy a visualization

No further endpoints are supported by this implementation and all return `{"message":"Access Denied", "code":"AccessDenied"}`.

## Credentials

Expand Down Expand Up @@ -60,7 +64,7 @@ You first need to create a private key:
scripts/keygen.sh
```

Which will create the file `keypair.pem` for you.
Which will create the file `keypair.pem` for you.

Then, you can run the server like this:

Expand All @@ -71,7 +75,7 @@ PRIV_KEY=`cat keypair.pem` cargo run
To run it at a different port, e.g. 3333:

```sh
ROCKET_PORT=3333 PRIV_KEY=`cat keypair.pem` cargo run
ROCKET_PORT=3333 PRIV_KEY=`cat keypair.pem` cargo run
```

## Running the server in a "Production" mode
Expand Down
1 change: 1 addition & 0 deletions endpoint/src/api_types.rs
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@
//! Use Case 001 REST API-related type definitions

#![allow(renamed_and_removed_lints)]
#![allow(clippy::blocks_in_conditions)]

use crate::datamodel::{PfId, ProductFootprint};
use chrono::{DateTime, Utc};
Expand Down
1 change: 1 addition & 0 deletions endpoint/src/auth.rs
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@
*/

#![allow(renamed_and_removed_lints)]
#![allow(clippy::blocks_in_conditions)]

use std::collections::HashSet;
use std::env;
Expand Down

0 comments on commit 80ba2d4

Please sign in to comment.