{ "informationService": { "descriptionInformation": { "descriptionIdentification": { "title": "Logon SWIM Ground Distribution Service", "edition": "1.0", "referenceDate": "2023-12-11" }, "abbreviations": [ { "name": "ANSP", "description": "Air Navigation Service Provider" }, { "name": "AO", "description": "Aircraft Operator" }, { "name": "API", "description": "Application Programmable Interface" }, { "name": "ATM", "description": "Air Traffic Management" }, { "name": "ATN", "description": "Aeronautical Telecommunication(s) Network" }, { "name": "ATS B2", "description": "Air Traffic Services Baseline 2" }, { "name": "CDA", "description": "Current Data Authority" }, { "name": "CM", "description": "Context Management" }, { "name": "CP1", "description": "Common Project 1" }, { "name": "DLIC", "description": "Data Link Initiation Capability" }, { "name": "EASA", "description": "European Union Aviation Safety Agency" }, { "name": "EC", "description": "European Commission" }, { "name": "EPP", "description": "Extended Projected Profile" }, { "name": "EUROCAE", "description": "European Organisation for Civil Aviation Equipment" }, { "name": "GAT", "description": "General Air Traffic" }, { "name": "GDSS", "description": "Ground Distribution Service Specification" }, { "name": "ICAO", "description": "International Civil Aviation Organization" }, { "name": "ICD", "description": "Interface Control Document" }, { "name": "LOF", "description": "Log-On Forwarding message (OLDI)" }, { "name": "LS", "description": "Logon Service" }, { "name": "NAN", "description": "Next Authority Notified message" }, { "name": "NDA", "description": "Next Data Authority" }, { "name": "NM", "description": "Network Manager" }, { "name": "OLDI", "description": "On-Line Data Interchange" }, { "name": "SASL", "description": "Simple Authentication and Security Layer" }, { "name": "SES", "description": "Single European Sky" }, { "name": "SWIM", "description": "System Wide Information Management" }, { "name": "TI", "description": "Technical Infrastructure" },{ "name": "UUIDv4", "description": "Universally Unique Identifier version 4" } ,{ "name": "VDLm2", "description": "VHF Digital Link Mode 2" }, { "name": "WS", "description": "Web Services" }, { "name": "XML", "description": "Extensible Markup Language" },{ "name": "XSD", "description": "XML Schema Definition" } ] }, "serviceIdentification": { "name": "Logon Ground Distribution Service", "version": "1.0" }, "serviceAbstract": "

The Logon Ground Distribution Service distributes to ground users Logon information directly received from ATS B2 equipped aircraft or forwarded by participating ANSPs. The service also handles the management of the CDA/NDA status of aircraft and can issue contact requests to log on to the Logon Service.

", "serviceDefinitionProvider": { "pointOfContact": [ { "name": "EUROCONTROL", "contactInformation": [ { "type": "EMAIL", "address": "swim@eurocontrol.int" } ] } ], "provider": "EUROCONTROL", "providerDescription": "

EUROCONTROL is an intergovernmental organisation with 41 Member and 2 Comprehensive Agreement States.

" }, "serviceCategorisation": { "serviceType": "SWIM_DEFINITION", "businessActivityType": [ "COMMUNICATION_NAVIGATION_SURVEILLANCE" ], "intendedConsumer": [ "AIRPORT_OPERATOR", "AIRSIDE_GROUND_HANDLER", "CIVIL_AIR_NAVIGATION_SERVICE_PROVIDER", "CIVIL_AIRSPACE_USER", "MILITARY_AIR_NAVIGATION_SERVICE_PROVIDER", "NETWORK_MANAGER" ], "informationCategory": [ "FLIGHT_INFORMATION_EXCHANGE" ], "applicationMessageExchangePattern": [ { "name": "ONE_WAY" }, { "name": "PUBLISH_SUBSCRIBE" }, { "name": "SYNCHRONOUS_REQUEST_REPLY" } ], "other": [ { "name": "Intended Service Provider", "value": "COMMUNICATION_NAVIGATION_AND_SURVEILLANCE_SERVICE_PROVIDER", "categorisationScheme": { "url": "https://reference.swim.aero/information-services/service-categories/CodeStakeholderType.html" } } ], "geospatialCategorisation": { "description": "This service shall provide information for the European ATM Network." } }, "generalDescription": { "operationalEnvironment": { "operationalNeeds": [ { "name": "Operational Needs", "description": "The datalink initiation and capability (DLIC) service is a pre-requisite for the initiation of CPDLC and ADS-C applications as detailed in ICAO/EUROCAE standards. The DLIC service is invoked when the flight deck crew issues a CM-logon request which indicates the supported applications and their versions. ANSPs need to be aware of the logon status to establish CPDLC connections and the ACS needs to be aware of the logon status to establish ADS-C contracts. Requesting the flight deck crew to manually issue two CM-logon requests is inefficient, especially when one considers that for the current ATN B1 datalink operations, not all crews perform this task. Therefore, the ground sharing of information between ANSPs and the Logon Service is essential. The Logon Service has been developed by the OEP 12.2 CONOPS document [5] and detailed in the Specification for Data Link Common Services for the Aeronautical Telecommunication Network (ATN) [1]. It also specifies the use of CM-forward and CM-contact services. All sources can be found in the EUROCONTROL Specification for Data Link Ground Distribution SWIM Services." }, { "name": "Information Exchange Requirements", "description": "The Logon Ground Distribution Service shall be implemented over a Technical Infrastructure conformant with the SWIM-TI Yellow Profile (v1.1+) Infrastructure Capabilities Specification. Conformance with the SWIM-TI Yellow Profile Infrastructure Capabilities Specification is achieved by satisfying the requirements of the Infrastructure Capabilities of the SWIM-TI Yellow Profile (v1.1+)" } ], "capabilities": [ { "name": "Capabilities", "description": "The ADS-C Ground Distribution Service enables a number of operational use cases that are described in the EUROCONTROL Specification for Data Link Ground Distribution SWIM Services: Provide Logon information by SWIM publication to the LS. Query Logon information from the LS. For the ACS to subscribe to logon information from the LS. For ANSPs to set and query the controlling authority status of an A/C. Consumer request to the LS to send a CM contact to a specific A/C. LS Status Monitoring." } ] }, "functionality": [ { "name": "Provide Logon information by SWIM publication to the LS", "description": "The service consumer (logon provider) shall be able to provide logon information from an aircraft.", "realWorldEffect": "The logon provider receives confirmation that the logon has been posted successfully." }, { "name": "Query Logon information from the LS", "description": "The service consumer shall be able to request Logon information from the LS synchronously or asynchronously.", "realWorldEffect": "The logon information can be obtained in two ways by the consumer. The first possibility will be a simple synchronous request to the LS and then a reply from the LS with the logon information. The second possibility will be a temporary request of logon information which would trigger an asynchronous demand to the LS. The consumer will then receive the requested logon information for a specified time frame." }, { "name": "For the ACS to subscribe to logon information from the LS", "description": "The service consumer (ACS) shall be able to subscribe to a particular set of logon information for an indefinite time frame.", "realWorldEffect": "The LS provides the consumer with the set of logon information when they become available." }, { "name": "For ANSPs to set and query the controlling authority status of an A/C", "description": "The service consumer shall be able to set or get the CDA/NDA status of an aircraft.", "realWorldEffect": "An ACC can provide to the LS the CDA/NDA status of an A/C. It can also update the CDA/NDA status. The LS also sends a confirmation that the CDA/NDA status has been changed." }, { "name": "Consumer request to the LS to send a CM contact to a specific A/C.", "description": "The service consumer shall be able to issue a request to the LS to send a CM-Contact to a particular aircraft.", "realWorldEffect": "Any authorised client of the LS (e.g an ACC) can make a request to the service to proceed to a CM contact to an A/C." }, { "name": "LS Status Monitoring", "description": "The service consumer shall be able to request the service status.", "realWorldEffect": "This operational use case enables a consumer of the Logon Service to receive technical messages about the status and health of the service." } ], "qualitiesOfService": { "performance": [ { "name": "Capacity", "description": "The service shall achieve a quality that is sufficient to ensure the service is fit for purpose." }, { "name": "Response time", "description": "The service shall achieve a quality that is sufficient to ensure the service is fit for purpose." } ], "reliability": [ { "name": "Availability", "description": "The service shall achieve a quality that is sufficient to ensure the service is fit for purpose." }, { "name": "Recoverability", "description": "The service shall achieve a quality that is sufficient to ensure the service is fit for purpose." } ], "security": [ { "name": "Confidentiality", "description": "The service shall ensure confidentiality by using SWIM Technical Infrastructure (TI) Yellow Profile bindings." }, { "name": "Integrity", "description": "The service shall ensure integrity by using SWIM Technical Infrastructure (TI) Yellow Profile bindings." } ] }, "qualityOfData": [ { "name": "Quality of Data", "description": "The information offered by the service shall be verified by the service provider. The information offered by the service shall be encoded according to the rules of the AIRM standard." } ], "accessAndUseConditions": [ { "name": "Authentication", "type": "SECURITY_CONSTRAINT", "description": "The service shall ensure consumer authentication in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile requirement SWIM-TIYP-0042 (use of a X.509 certificate). The service shall ensure provider authentication in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile requirement SWIM-TIYP-0042 (use of a X.509 certificate)." }, { "name": "Authorisation", "type": "SECURITY_CONSTRAINT", "description": "The service shall ensure that satisfactory authorisation is put in place according to EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile requirement SWIM-TIYP-0070. The specific details of the authorization verification are left as an implementation choice for the service provider, they could include aspects like: Number of active contract requests by the consumer, Number of pending contract requests by the consumer, Consumer permissions. " }, { "name": "Confidentiality", "type": "SECURITY_CONSTRAINT", "description": "The service shall ensure point-to-point confidentiality in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile through the use of Transport Layer Security (TLS) 1.2 or above." }, { "name": "Integrity", "type": "SECURITY_CONSTRAINT", "description": "The service shall ensure point-to-point integrity in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile through the use of Transport Layer Security (TLS) 1.2 or above." } ] }, "informationDescription": { "filtering": { "capability": [ { "name": "Filter Encoding", "description": "The following interfaces shall allow for the selection of subscription based on clearly defined criteria: Logon Subscription Management Interface, Asynchronous Logon Information Request Interface. Subscription and AMQP 1.0 message filtering can be done based on the value of this application-property using the APACHE.ORG:SELECTOR syntax. The service may support other filters based on the operators defined in the OGC Filter Encoding 2.0 Encoding Standard on a case by case basis." } ] }, "informationDefinition": [ { "name": "Logon GDSS", "definition": "The Logon Ground Distribution Service distributes to ground users Logon information directly received from ATS B2 equipped aircraft or forwarded by participating ANSPs.", "airmCorrespondence": "urn:aero:airm:1.0.0:LogicalModel:Subjects:Stakeholders:BusinessService:RadioCommunicationChannel@logon" } ] }, "technicalDescription": { "serviceMonitoring": { "monitoringDescription": "A service monitoring mechanism shall be made available to service consumers. The Service Status Monitoring Interface covers the Service Monitoring requirement." }, "behaviour": [ { "name": "Typical Behaviour", "description": "The service behaviour shall be in accordance with the patterns detailed in the Message Exchange Patterns: Identification Guidelines. The service behaviour is completely described in the EUROCONTROL Specification for Data Link Ground Distribution SWIM Services in chapter 5 containing all sequence diagrams for each interfaces of the service." } ] }, "serviceInterface": [ { "name": "Logon Information Management Interface", "description": "The Logon Information Management Interface allows a consumer of the Logon Ground Distribution SWIM Service to synchronously post and receive logon information from logon providers and receivers respectively.", "provisionSide": "PROVIDER_SIDE", "endpoints": [ { "name": "/aircraft?flightId=[&adep=][&ades=]/", "url": "https://localhost/aircraft" }, { "name": "/aircraft//logon/", "url": "https://localhost/aircraft/aircraftAddressHex/logon/" }, { "name": "/aircraft//logon-via-contact/", "url": "https://localhost/aircraft/aircraftAddressHex/logon-via-contact/" }, { "name": "/aircraft//logon-via-forward/", "url": "https://localhost/aircraft/aircraftAddressHex/logon-via-forward/" } ], "serviceInterfaceBinding": { "name": "WS_LIGHT", "description": "The WS Light Interface Binding as detailed in the EUROCONTROL Specification for SWIM Technical Infrastructure Yellow Profile, edition 1.1." }, "networkInterfaceBinding": { "name": "Selected network interface binding", "description": "The service shall use the network bindings of the SWIM Technical Infrastructure (TI) Yellow Profile." }, "operations": [ { "name": "Get icao Aircraft Address", "description": "The Logon Information Management Interface allows a consumer of the Logon Ground Distribution SWIM Service to synchronously query the ICAO 24-bit Aircraft Address of an aircraft. The interface shall return a 'getAircraftAddressReply' detailing the aircraft address information upon successful validation of the 'getAircraftAddressRequest'. The Logon Information Management Interface shall support the following HTTP method on the /aircraft endpoint: GET", "messages": [ { "name": "getAircraftAddressRequest", "direction": "IN" }, { "name": "getAircraftAddressReply", "direction": "OUT" } ] }, { "name": "Provide Logon Information", "description": "The Logon Information Management Interface allows a consumer of the Logon Ground Distribution SWIM Service to synchronously post logon information from logon providers and receivers respectively. The Consumer receives a provideLogonInfoReply message as a response upon successful processing of the request provideLogonInfoRequest. The Logon Information Management Interface shall support the following HTTP method on the /aircraft//logon endpoint: PUT", "messages": [ { "name": "provideLogonInfoRequest", "direction": "IN" }, { "name": "provideLogonInfoReply", "direction": "OUT" } ] }, { "name": "Query Logon Information", "description": "The Logon Information Management Interface allows a consumer of the Logon Ground Distribution SWIM Service to synchronously receive logon information from logon providers and receivers respectively. The Consumer receives a getAircraftAddressReply detailing the aircraft address information upon successful validation of the getAircraftAddressRequest.", "messages": [ { "name": "getLogonInfoRequest", "direction": "IN" }, { "name": "getLogonInfoReply", "direction": "OUT" } ] }, { "name": "Query Logon information via CM Contact", "description": "The Logon Information Management Interface allows a consumer of the Logon Ground Distribution SWIM Service to synchronously receive logon information via the CM-Contact mechanism.", "messages": [ { "name": "getLogonInfoRequest", "direction": "IN" }, { "name": "getLogonInfoViaReply", "direction": "OUT" } ] }, { "name": "Query Logon Information via CM Forward", "description": "The Logon Information Management Interface allows a consumer of the Logon Ground Distribution SWIM Service to synchronously receive logon information via the CM-Forward mechanism.", "messages": [ { "name": "getLogonInfoRequest", "direction": "IN" }, { "name": "getLogonInfoViaReply", "direction": "OUT" } ] } ], "messages": [ { "name": "getAircraftAddressRequest", "description": "This message allows a service consumer to request ICAO 24-bit Aircraft Address of a specific aircraft.", "isError": false }, { "name": "getAircraftAddressReply", "description": "The reply message of the aircraft address request containing the ICAO 24-bit aircraft address in hexadecimal representation.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-getAircraftAddressReply.xsd" }, "isError": false }, { "name": "provideLogonInfoRequest", "description": "This message allows a service consumer to provide the logon information of a specific aircraft.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-LogonInfo.xsd" }, "isError": false }, { "name": "provideLogonInfoReply", "description": "The reply message to the provideLogonInfoRequest confirming the Provide Logon Information message has been delivered.", "isError": false }, { "name": "getLogonInfoRequest", "description": "The reply message of the aircraft address request containing the ICAO 24-bit aircraft address in hexadecimal representation.", "isError": false }, { "name": "getLogonInfoReply", "description": "The reply message of the aircraft address request containing the ICAO 24-bit aircraft address in hexadecimal representation.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-LogonInfo.xsd" }, "isError": false }, { "name": "getLogonInfoViaReply", "description": "The reply message to the getLogonInfoRequest when the query logon information operation is chosen via the /logon-via-contact or /logon-via-forward endpoints. This also returns the logon information via the chosen CM method.", "isError": false } ] }, { "name": "Asynchronous Logon Information Request Interface", "description": "The Asynchronous Logon Information Request Interface allows a consumer of the Logon Ground Distribution SWIM Service to temporarily subscribe to a particular set of logon information via the Asynchronous Logon Information Publication Interface. This means the consumer can specify a certain time frame in which he would like to receive the logon information. This consumer will also be able to specify in which way he would like to get the logon information (SWIM, CM Forward, CM Contact).", "provisionSide": "PROVIDER_SIDE", "endpoints": [ { "name": "/aircraft//async-logon/", "url": "https://localhost/aircraft/aircraftAddressHex/async-logon/" }, { "name": "/aircraft//async-logon//", "url": "https://localhost/aircraft/aircraftAddressHex/async-logon/asyncLogonId/" } ], "serviceInterfaceBinding": { "name": "WS_LIGHT", "description": "The WS Light Interface Binding as detailed in the EUROCONTROL Specification for SWIM Technical Infrastructure Yellow Profile, edition 1.1." }, "networkInterfaceBinding": { "name": "selected network interface binding", "description": "The service shall use the network bindings of the SWIM Technical Infrastructure (TI) Yellow Profile." }, "operations": [ { "name": "Request Asynchronous Logon Information", "description": "The Asynchronous Logon Information Request Interface allows a consumer of the Logon Ground Distribution SWIM Service to temporarily subscribe to a particular set of logon information via the Asynchronous Logon Information Publication Interface. This means the consumer can specify a certain time frame in which he would like to receive the logon information. This consumer will also be able to specify in which way he would like to get the logon information (SWIM, CM Forward, CM Contact). The Asynchronous Logon Information Request Interface shall support the following HTTP method on the /aircraft//async-logon/ endpoint", "messages": [ { "name": "asyncLogonInfoRequest", "direction": "IN" }, { "name": "asyncLogonInfoReply", "direction": "OUT" } ] }, { "name": "Delete Asynchronous Logon Information", "description": "Delete Logon Information Subscription via the /aircraft//async-logon// endpoint.", "messages": [ { "name": "deleteAsyncLogonInfo", "direction": "IN" }, { "name": "deleteAsyncLogonInfoReply", "direction": "OUT" } ] }, { "name": "List Asynchronous Logon Information", "description": "Getting the list the active logon information subscriptions via the /aircraft//async-logon/ endpoint.", "messages": [ { "name": "getAsyncLogonInfo", "direction": "IN" }, { "name": "getAsyncLogonInfoReply", "direction": "OUT" } ] } ], "messages": [ { "name": "asyncLogonInfoRequest", "description": "This messages allows a service consumer to temporarily subscribe to a particular set of logon information. The consumer can specify a certain time frame in which he would like to receive the logon information. This consumer will also be able to specify in which way he would like to get the logon information (SWIM, CM Forward, CM Contact).", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-AsyncRequest.xsd" }, "isError": false }, { "name": "asyncLogonInfoReply", "description": "The reply message to the asyncLogonInfoRequest returning the logon information to the consumer.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-AsyncRequest.xsd" }, "isError": false }, { "name": "deleteAsyncLogonInfo", "description": "This messages allows a service consumer to delete its subscription to a particular set of logon information.", "isError": false }, { "name": "deleteAsyncLogonInfoReply", "description": "The reply message to the deleteAsyncLogonInfo confirming the subscription was successfully deleted.", "isError": false }, { "name": "getAsyncLogonInfo", "description": "This messages allows a service consumer to list its subscriptions.", "isError": false }, { "name": "getAsyncLogonInfoReply", "description": "The reply message to the getAsyncLogonInfo listing the consumer's subscriptions.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-AsyncRequest.xsd" }, "isError": false } ] }, { "name": "Asynchronous Logon Information Publication Interface", "description": "The Asynchronous Logon Information Publication Interface allows a consumer of the Logon Ground Distribution SWIM Service to obtain Logon information of flights he is interested in temporarily and asynchronously.", "provisionSide": "PROVIDER_SIDE", "serviceInterfaceBinding": { "name": "SWIM_TI_YP_1_1_AMQP_MESSAGING", "description": "The AMQP_MESSAGING Interface Binding as detailed in the EUROCONTROL Specification for SWIM Technical Infrastructure Yellow Profile, edition 1.1" }, "networkInterfaceBinding": { "name": "selected network interface binding", "description": "The service shall use the network bindings of the SWIM TIYP. AMQP 1.0 shall be used to distribute messages as explained in the Publish/Subscribe Push MEP: Implementation Guidance: https://reference.swim.aero/technical-infrastructure/guidance-for-pub-sub-push-implementation.html" }, "operations": [ { "name": "Publish", "description": "The Asynchronous Logon Information Publication Interface allows a consumer of the Logon Ground Distribution SWIM Service to obtain Logon information of flights he is interested in temporarily and asynchronously. To do so, it starts by creating an endpoint from which a consumer can listen to updates of flights temporarily. In which case he will receive in its asynchronous request response the endpoint address created specifically for his request. The dynamic endpoint created for a specific request is labelled by /
in this document, the specific value taken by the
placeholder is resolved in runtime and provided in the asynchronous request response.", "messages": [ { "name": "/
dynamic endpoint, AMQP node", "direction": "OUT" } ] } ] }, { "name": "Aircraft Contact Interface", "description": "The Aircraft Contact Interface allows a consumer of the Logon Ground Distribution SWIM Service to issue a request to the LS to send a CM-Contact to a particular aircraft.", "provisionSide": "PROVIDER_SIDE", "endpoints": [ { "name": "/aircraft//contact/", "url": "https://localhost/aircraft/aircraftAddressHex/contact/" } ], "serviceInterfaceBinding": { "name": "WS_LIGHT" }, "networkInterfaceBinding": { "name": "selected network interface binding", "description": "The service shall use the network bindings of the SWIM Technical Infrastructure (TI) Yellow Profile." }, "operations": [ { "name": "Request CM Contact", "description": "The Aircraft Contact Interface allows a consumer of the Logon Ground Distribution SWIM Service to issue a request to the LS to send a CM-Contact to a particular aircraft. The Aircraft Contact Interface shall expose the following endpoint for consumers to request the LS to issue a CM contact: /aircraft//contact", "messages": [ { "name": "requestContactRequest", "direction": "IN" }, { "name": "requestContactReply", "direction": "OUT" } ] } ], "messages": [ { "name": "requestContactRequest", "description": "This message allows a service consumer to make a request to the Logon service to send a CM-contact to a particular aircraft.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-Contact.xsd" }, "isError": false }, { "name": "requestContactReply", "description": "The reply message to the requestContactRequest confirming the message was well delivered.", "isError": false } ] }, { "name": "Authority Management Interface", "description": "The Authority Management Interface allows a consumer of the Logon Ground Distribution SWIM Service to synchronously set the CDA/NDA status of an aircraft.", "provisionSide": "PROVIDER_SIDE", "endpoints": [ { "name": "/aircraft//CDA/", "url": "https://localhost/aircraft/aircraftAddressHex/CDA/" }, { "name": "/aircraft//NDA/", "url": "https://localhost/aircraft/aircraftAddressHex/NDA/" } ], "serviceInterfaceBinding": { "name": "WS_LIGHT" }, "networkInterfaceBinding": { "name": "selected network interface binding", "description": "The service shall use the network bindings of the SWIM Technical Infrastructure (TI) Yellow Profile." }, "operations": [ { "name": "Set CDA", "description": "The Authority Management Interface allows a consumer of the Logon Ground Distribution SWIM Service to synchronously set the CDA status of an aircraft.", "messages": [ { "name": "setCDARequest", "direction": "IN" }, { "name": "setCDAReply", "direction": "OUT" } ] }, { "name": "Set NDA", "description": "The Authority Management Interface allows a consumer of the Logon Ground Distribution SWIM Service to synchronously set the NDA status of an aircraft.", "messages": [ { "name": "setNDARequest", "direction": "IN" }, { "name": "setNDAReply", "direction": "OUT" } ] }, { "name": "Get CDA", "description": "The Authority Management Interface allows a consumer of the Logon Ground Distribution SWIM Service to synchronously query the CDA status of an aircraft.", "messages": [ { "name": "getCDARequest", "direction": "IN" }, { "name": "getCDAReply", "direction": "OUT" } ] }, { "name": "Get NDA", "description": "The Authority Management Interface allows a consumer of the Logon Ground Distribution SWIM Service to synchronously query the NDA status of an aircraft.", "messages": [ { "name": "getNDARequest", "direction": "IN" }, { "name": "getNDAReply", "direction": "OUT" } ] } ], "messages": [ { "name": "setCDARequest", "description": "This message allows a service consumer to set the Current Data Authority (CDA) status of a particular aircraft.", "isError": false }, { "name": "setCDAReply", "description": "The reply message to the setCDARequest confirming the message was well delivered.", "isError": false }, { "name": "setNDARequest", "description": "This message allows a service consumer to set the Next Data Authority (NDA) status of a particular aircraft.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-SetNDARequest.xsd" }, "isError": false }, { "name": "setNDAReply", "description": "The reply message to the setNDARequest confirming the message was well delivered.", "isError": false }, { "name": "getCDARequest", "description": "This message allows a service consumer to request the Current Data Authority (CDA) status of a particular aircraft.", "isError": false }, { "name": "getCDAReply", "description": "The reply message to the getCDARequest confirming the message was well delivered.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-CDA_NDA-Reply.xsd" }, "isError": false }, { "name": "getNDARequest", "description": "This message allows a service consumer to request the Next Data Authority (NDA) status of a particular aircraft.", "isError": false }, { "name": "getNDAReply", "description": "The reply message to the getNDARequest confirming the message was well delivered.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-CDA_NDA-Reply.xsd" }, "isError": false } ] }, { "name": "Logon Subscription Management Interface", "description": "The Logon Subscription Management Interface allows a consumer of the Logon Ground Distribution SWIM Service to subscribe to a particular set of logon information via the Logon Data Publication Interface.", "provisionSide": "PROVIDER_SIDE", "endpoints": [ { "name": "/logonSubscriptions/", "url": "https://localhost/logonSubscriptions/" }, { "name": "/logonSubscriptions/", "url": "https://localhost/logonSubscriptions/subscriptionId" } ], "serviceInterfaceBinding": { "name": "WS_LIGHT" }, "networkInterfaceBinding": { "name": "selected network interface binding", "description": "The service shall use the network bindings of the SWIM Technical Infrastructure (TI) Yellow Profile." }, "operations": [ { "name": "subscribe", "description": "This operation allows a consumer of the SWIM Logon Ground Distribution Service to select the set of logon information he is interested to receive via the Logon Data Publication Interface. The Logon Subscription Management Interface shall expose the following endpoint for consumers to manage their subscriptions: /logonSubscriptions The Logon Subscription Management Interface shall create the following endpoint upon successful validation of the subscriptionRequest: /logonSubscriptions/", "messages": [ { "name": "subscriptionRequest", "direction": "IN" }, { "name": "subscriptionReply", "direction": "OUT" } ] }, { "name": "unsubscribe", "description": "This operation allows a service consumer to unsubscribe from the set of logon information changes he is subscribed to. The Logon Subscription Management Interface shall support the following HTTP method on the /logonSubscriptions/ endpoints: -DELETE", "messages": [ { "name": "unsubscriptionRequest", "direction": "IN" }, { "name": "unsubscriptionReply", "direction": "OUT" } ] }, { "name": "list subscriptions", "description": "This operation allows a service consumer to obtain the list of subscriptions. The Logon Subscription Management Interface shall support the following HTTP method on the /logonSubscriptions endpoint: -GET", "messages": [ { "name": "getsubscriptionsRequest", "direction": "IN" }, { "name": "getsubscriptionsReply", "direction": "OUT" } ] }, { "name": "subscription details", "description": "This operation allows a service consumer to obtain information on a specific subscriptions. The Logon Subscription Management Interface shall support the following HTTP method on the /logonSubscriptions/ endpoint: -GET", "messages": [ { "name": "subscriptionDetailsRequest", "direction": "IN" }, { "name": "subscriptionDetailsReply", "direction": "OUT" } ] } ], "messages": [ { "name": "subscriptionRequest", "description": "This message allows a consumer of the service to subscribe to a set of logon information he is interested in.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-SMI-subscriptionRequest.xsd" }, "isError": false }, { "name": "subscriptionReply", "description": "The reply message of the subscription request indicating the subscription is confirmed.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-SMI-subscriptionReply.xsd" }, "isError": false }, { "name": "unsubscriptionRequest", "description": "This message allows a consumer of the service to unsubscribe to a subscription he previously made.", "isError": false }, { "name": "unsubscriptionReply", "description": "The reply message of the logon information unsubscription request confirming the unsubscription was successful.", "isError": false }, { "name": "getSubscriptionRequest", "description": "This message allows a consumer of the service to list the subscriptions he is currently subscribed to.", "isError": false }, { "name": "getSubscriptionReply", "description": "The reply message of the list subscriptions request which is confirmed and detailing the list of subscriptions he has.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-SMI-getSubscriptionsReply.xsd" }, "isError": false }, { "name": "subscriptionDetailsRequest", "description": "This message allows a consumer of the service to get the details of his subscriptions.", "isError": false }, { "name": "subscriptionDetailsReply", "description": "The reply message of the subscriptions details request which is confirmed and giving the details of the subscriptions the service consumer.", "schema": { "url": "https://github.com/eurocontrol-swim/logon-ground-distribution-service-schemas/blob/main/LS-SMI-subscriptionDetailsReply.xsd" }, "isError": false } ] }, { "name": "Logon Data Publication Interface", "description": "The Logon Data Publication Interface allows a consumer of the Logon Ground Distribution SWIM Service to asynchronously obtain Logon information of flights he is interested in. It provides two ways of doing so: By creating an endpoint from which a consumer can listen to updates of flights matching certain filtering criteria defined in a subscription created through the Logon Subscription Management Interface. In which case he will receive in its subscription response the endpoint address created specifically for his subscription. The dynamic endpoint created for a specific subscription is labelled by /
in this document, the specific value taken by the
placeholder is resolved in runtime and provided in the subscription response. By defining a number of preconfigured static endpoints where predefined filters are already applied. These preconfigured static endpoints do not require the creation of a specific subscription by the consumer, they are created in design-time by the service provider and are readily available for any consumer, subject to authorization verification. These static endpoints are labelled by / in this document, the specific values taken by these endpoints is defined by the service provider during design-time", "provisionSide": "PROVIDER_SIDE", "serviceInterfaceBinding": { "name": "SWIM_TI_YP_1_1_AMQP_MESSAGING", "description": "The AMQP_MESSAGING Interface Binding as detailed in the EUROCONTROL Specification for SWIM Technical Infrastructure Yellow Profile, edition 1.1" }, "networkInterfaceBinding": { "name": "selected network interface binding", "description": "The service shall use the network bindings of the SWIM TIYP. AMQP 1.0 shall be used to distribute messages as explained in the Publish/Subscribe Push MEP: Implementation Guidance: https://reference.swim.aero/technical-infrastructure/guidance-for-pub-sub-push-implementation.html" }, "operations": [ { "name": "publish", "description": "The Logon Data Publication Interface allows a consumer of the Logon Ground Distribution SWIM Service to asynchronously obtain Logon information of flights he is interested in. By creating an endpoint from which a consumer can listen to updates of flights matching certain filtering criteria defined in a subscription created through the Subscription Management Interface. In which case he will receive in its subscription response the endpoint address created specifically for his subscription. The dynamic endpoint created for a specific subscription is labelled by /
in this document, the specific value taken by the
placeholder is resolved in runtime and provided in the subscription response.", "messages": [ { "name": "/
dynamic endpoint, AMQP node", "direction": "OUT" } ] }, { "name": "publish", "description": "This operation allows the service provider to publish Logon data to service consumers based on a list of predefined filters. By defining a number of preconfigured static endpoints where predefined filters are already applied. These preconfigured static endpoints do not require the creation of a specific subscription by the consumer, they are created in design-time by the service provider and are readily available for any consumer, subject to authorization verification. These static endpoints are labelled by / in this document, the specific values taken by these endpoints is defined by the service provider during design-time.", "messages": [ { "name": "/ predefined static endpoint, AMQP node", "direction": "OUT" } ] } ] }, { "name": "Service Status Monitoring Interface", "description": "This operation allows the interface consumer to retrieve updates of the SWIM Logon Ground Distribution Service health and operational status.", "provisionSide": "PROVIDER_SIDE", "serviceInterfaceBinding": { "name": "SWIM_TI_YP_1_1_AMQP_MESSAGING", "description": "The WS Light Interface Binding as detailed in the EUROCONTROL Specification for SWIM Technical Infrastructure Yellow Profile, edition 1.1." }, "networkInterfaceBinding": { "name": "Selected network interface binding", "description": "The Service Status Monitoring Interface shall be conformant with the SWIM-TI Yellow Profile (v1.1+) Network Interface Bindings Specification." }, "operations": [ { "name": "publish", "description": "This operation allows the interface consumer to retrieve updates of the SWIM Logon Ground Distribution Service health and operational status." } ] } ], "references": { "serviceDocument": [ { "documentType": "SERVICE_SPECIFICATION", "title": "EUROCONTROL Specification for Data Link Common Services for the Aeronautical Telecommunication Network (ATN), edition 1.0", "version": "-", "description": "This specification contains requirements for the ground implementation of data link common services for the Aeronautical Telecommunications Network (ATN) as defined by ICAO Annex 10 (Volume III, Part 1) https://www.eurocontrol.int/publication/eurocontrol-specification-data-link-common-services-aeronautical-telecommunication - 11/12/23" }, { "documentType": "SERVICE_SPECIFICATION", "title": "EUROCONTROL Specification for SWIM Service Description, EUROCONTROL-SPEC-168, Edition 2.0", "version": "-", "description": "This specification contains requirements for service descriptions in the context of System Wide Information Management (SWIM) in Europe. https://www.eurocontrol.int/publication/eurocontrol-specification-swim-service-description-sd - 15/03/22" }, { "documentType": "INFORMATION_DEFINITION", "title": "EUROCONTROL Specification for SWIM Information Definition, EUROCONTROL-SPEC-169, Edition 1.0", "version": "-", "description": "The EUROCONTROL Specification for SWIM Information Definition contains requirements for information definitions in the context of iSWIM in Europe. https://www.eurocontrol.int/publication/eurocontrol-specification-swim-information-definition - 01/12/17" }, { "documentType": "SERVICE_SPECIFICATION", "title": "EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile, EUROCONTROL-SPEC-170, Edition 1.1", "version": "-", "description": "The EUROCONTROL Specification for SWIM Technical Infrastructure Yellow Profile contains requirements for system interfaces (e.g. protocols) and for IT infrastructure capabilities required to enable a reliable, secure and efficient exchange of information in the context of iSWIM. This contributes to technical interoperability. https://www.eurocontrol.int/publication/eurocontrol-specification-swim-technical-infrastructure-ti-yellow-profile 05/07/20" }, { "documentType": "OTHER", "title": "SESAR PJ38 PJ38-ADSCENSIO DEMOR Release 2, Deliverable D.1.2", "version": "-", "description": "Aircraft can provide essential information to support accurate and reliable trajectory prediction or alternative scenarios during the execution of a flight. The EU-funded PJ38-W3-ADSCENSIO project will improve several characteristics of air traffic control through the better prediction of flights’ behaviour. The project demonstrated the improvements in several operations performed by air traffic controllers as well as the efficiency and strength of a technological infrastructure to support the data link communications between the aircraft and ground on trajectory-related exchanges. The adoption of technical and operational solutions reduced controller workload in high traffic conditions, increase airspace capacity, and reduce flight delays, fuel consumption and CO2 emissions. https://cordis.europa.eu/project/id/101017626/results 27/06/23" }, { "documentType": "SERVICE_STANDARD", "title": "EUROCAE, ED-228A, Safety and Performance Requirements Standard for Baseline 2 ATS Data Communications (Baseline 2 SPR Standard)", "version": "-", "description": "This standard provides the operational, safety, and performance requirements (SPR) for the implementation of data communication services that support air traffic services (ATS). https://eshop.eurocae.net/eurocae-documents-and-reports/ed-228a/# - 2016" }, { "documentType": "SERVICE_STANDARD", "title": "EUROCAE, ED-228B, Safety and Performance Requirements Standard for Baseline 2 ATS Data Communication", "version": "-", "description": "This standard provides the operational, safety, and performance requirements (SPR) for the implementation of data communication services that support air traffic services (ATS). It is intended to support the communication element of the implementation of communication, navigation, and surveillance / air traffic management (CNS/ATM) systems in worldwide application. Revision B will take into account results from SESAR and NextGen validation exercises. It will also align the standard to relevant ICAO documentation and remove the D-RNP Requirements. https://www.eurocae.net/news/posts/2023/october/ed-228b-safety-and-performance-standard-for-baseline-2-ats-data-communication/ - 09/23" }, { "documentType": "SERVICE_STANDARD", "title": "EUROCAE, ED-229-A Interoperability Requirements Standard for Baseline 2 ATS Data Communications (Baseline 2 Interop Standard)", "version": "-", "description": "This document provides the interoperability requirements (INTEROP) standard for the implementation of the Air Traffic Service (ATS) applications supporting the Baseline 2 data link services as specified in the Baseline 2 Safety and Performance Requirements (SPR) document [10]. This document addresses the interoperability of the ATS applications using the Aeronautical Telecommunication Network (ATN). https://eshop.eurocae.net/eurocae-documents-and-reports/ed-229a/ - 01/01/2016" }, { "documentType": "SERVICE_STANDARD", "title": "EUROCAE, ED-229B, Interoperability Requirements Standard for Baseline 2 ATS Data Communication", "version": "-", "description": "This document provides the interoperability requirements (INTEROP) standard for the implementation of the Air Traffic Service (ATS) applications supporting the Baseline 2 data link services as specified in the Baseline 2 Safety and Performance Requirements (SPR) document. Revision B takes into account results from SESAR and NextGen validation exercises, and maintaining portable data link services and applications independent, to the maximum extent practical, of the underlying network technology. Revision B will take into account results from SESAR and NextGen validation exercises. It will also align the standard to relevant ICAO documentation and remove the D-RNP Requirements. https://www.eurocae.net/news/posts/2023/october/ed-229b-interoperability-requirements-standard-for-baseline-2-ats-data-communications/ 09/23" }, { "documentType": "OTHER", "title": "OASIS, Advanced Message Queuing Protocol (AMQP)", "version": "-", "description": "The Advanced Message Queuing Protocol (AMQP) is an open internet protocol for business messaging. It defines a binary wire-level protocol that allows for the reliable exchange of business messages between two parties. AMQP has a layered architecture and the specification is organized as a set of parts that reflects that architecture. Part 1 defines the AMQP type system and encoding. Part 2 defines the AMQP transport layer, an efficient, binary, peer-to-peer protocol for transporting messages between two processes over a network. Part 3 defines the AMQP message format, with a concrete encoding. Part 4 defines how interactions can be grouped within atomic transactions. Part 5 defines the AMQP security layers. https://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html 10/12" }, { "documentType": "OTHER", "title": "EUROCONTROL, Message Exchange Patterns: Identification Guidelines", "version": "-", "description": "A message exchange pattern (MEP) identifies a repeatable sequence of messages exchanged between two systems, specifying the order, direction and cardinality of these messages (e.g. Request/Reply, Publish/Subscribe). https://reference.swim.aero/technical-infrastructure/message-exchange-patterns-identification-guidelines.html 02/07/19" }, { "documentType": "OTHER", "title": "SESAR Deployment Programme Edition 2022", "version": "-", "description": "The SESAR Deployment Programme provides a common workplan to all operational stakeholders involved in the deployment of Regulation (EU) n. 2021/116, so called Common Project One (CP1), clearly defining the scope of the implementation activities, the synchronisation needs, as well as the suggested deployment approach. https://assets.ctfassets.net/krj50g99u3hm/3UqsgbBqgoXAPsnTXromQ4/6b4c06833b036866206b58fd69d63a0f/SESAR_Deployment_Programme_2022_approved.pdf" }, { "documentType": "OTHER", "title": "AMQP 1.0 Filters", "version": "-", "description": "https://www.amqp.org/specification/1.0/filters" }, { "documentType": "OTHER", "title": "Operation Excellence Programme Workstream 12.2 Concept of Operations (Deliverable DEL2.1-1)", "version": "-", "description": "The objective of this document is to describe the Concept of Operations (CONOPS) upon which the development of standardisation material will be prepared for the Operational Excellence Programme (OEP) workstream topic 12.2 to support implementation of the CP1 regulation [Ref 11] on ATM Functionality 6 (AF6) (Initial Trajectory Sharing). https://www.eurocontrol.int/sites/default/files/2022-10/eurocontrol-oep-12-2-workshop-conops-edition-1-0.pdf" }, { "documentType": "POLICY_DOCUMENT", "title": "Commission Implementing Regulation (EU) No 2021/116 of 1 February 2021 on the establishment of the Common Project One", "version": "-", "description": "The Single European Skys ATM Research project, SESAR, is one of the most ambitious modernisation projects launched by the European Union, contributing to the implementation of the Single European Sky. SESARs goal is to define, develop and deploy the technological solutions needed to increase the performance and digitalisation of Europes ATM system in the most cost-, flight-efficient and environmentally friendly conditions. The adoption of the Reg. (EU) n. 716/2014 (Pilot Common Project or PCP), the establishment of the SESAR Deployment Manager as per Reg. (EU) n. 409/2013, as well as the subsequent elaboration of the initial SESAR Deployment Programme, marked all together a key step towards the Deployment Phase of SESAR. https://www.sesardeploymentmanager.eu/news/common-project-1-a-new-european-regulation-ensuring-the-continuation-of#:~:text=2021%2F116%2C%20Common%20Project%201,(ATM)%20modernisation%20in%20Europe 02/02/2021" } ] } } }