Skip to content

Commit ea5bf20

Browse files
committed
Auth summary update to general info
1 parent ba9655a commit ea5bf20

1 file changed

Lines changed: 3 additions & 5 deletions

File tree

general-information.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,17 +27,15 @@ This document contains specifications that are shared between the various MDS [A
2727

2828
## Authorization
2929

30-
TBD
30+
Outlines shared authorization details and methods across all MDS APIs.
3131

3232
### Endpoint Requirements
3333

3434
All MDS Provider, Agency, and Metrics APIs require authentication, as outlined.
3535

3636
If implementing MDS Policy, Geography, and/or Jurisdiction APIs and endpoints, an agency must make them unauthenticated and public. This allows transparency for the public to see how the city is regulating, holds the city accountable for their policy decisions, and reduces the technical burden on providers to use these endpoints. A side benefit is that this allows third parties to ingest this information into their applications and services for public benefit.
3737

38-
All Provider endpoints must be authenticated, to protect potentially sensitive information.
39-
40-
As of MDS 0.3.0, `gbfs.json` is required. The required GBFS endpoints should be made available publicly. See [#realtime-data](https://github.com/openmobilityfoundation/mobility-data-specification/tree/main/provider#realtime-data) for more information about how to implement GBFS for dockless systems.
38+
As of MDS 0.3.0, `gbfs.json` is required. The required GBFS endpoints should be made available publicly. See Provider [#realtime-data](https://github.com/openmobilityfoundation/mobility-data-specification/tree/main/provider#realtime-data) for more information about how to implement GBFS for dockless systems.
4139

4240
### Header
4341

@@ -69,7 +67,7 @@ OAuth 2.0's `client_credentials` grant type (outlined in [RFC6749](https://tools
6967

7068
OAuth 2.0 is an industry standard authorization framework with a variety of existing tooling. The `client_credentials` grant type facilitates generation of tokens that can be used for access by agencies and distributed to data partners.
7169

72-
If an MDS provider implements this auth scheme, it **MAY** choose to specify token scopes that define access parameters like allowable time ranges. These guidelines **SHOULD** be encoded into the returned token in a parseable way.
70+
If an MDS endpoint producer implements this auth scheme, it **MAY** choose to specify token scopes that define access parameters like allowable time ranges. These guidelines **SHOULD** be encoded into the returned token in a parsable way.
7371

7472
[Top][toc]
7573

0 commit comments

Comments
 (0)