From 485efa30bc708f4da54a54c531b995ae97286d95 Mon Sep 17 00:00:00 2001 From: Jenny Ramseyer Date: Fri, 1 Mar 2024 13:52:20 -0500 Subject: [PATCH] Update draft-ramseyer-grow-peering-api.md Add "Audience" section to indicate to readers who the suggested users of this API might be. --- draft-ramseyer-grow-peering-api.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/draft-ramseyer-grow-peering-api.md b/draft-ramseyer-grow-peering-api.md index 7823d77..09a7816 100644 --- a/draft-ramseyer-grow-peering-api.md +++ b/draft-ramseyer-grow-peering-api.md @@ -118,6 +118,21 @@ This combination provides a low entry barrier to create an identity federation a The authors recognize that not all partners have the time or engineering resources to support all authorization standards, so the API reference implementations will offer an extensible security mechanism to meet varying identity and security requirements. For RPKI-based authentication, this document refers to RPKI Signed Checklists (RSCs) ({{?RFC9323}}). +The Peering API does not enforce any kind of peering policy on the incoming requests. +It is left to the server implementation to enforce the AS-specific peering policy. +The authors encourage each peer to consider the needs of their peering policy and implement request validation as desired. + + +Audience {#audience} +======== +The Peering API aims to simplify peering interconnection configuration. +To that end, the API can be called by either a human or some automation. +A network engineer can submit API requests through a client-side tool, and configure sessions by hand or through existing tooling. +Alternately, an automated service can request BGP sessions through some trigger or regularly scheduled request (for example, upon joining a new peering location, or through regular polling of potential peers). +That automated client can then configure the client sessions through its own tooling. +For ease of exchanging peering requests, the authors suggest peers to maintain both a client and a server for the API. +Toward the goal of streamlining peering configuration, the authors encourage peers to automate their network configuration wherever possible, but do not require full automation to use this API. + Protocol {#protocol} ========