1. While the audience is gathering. During breaks etc
While the audience is gathering. During breaks etc. Simple messages can be added in bold and white letters on the dark blue sea, eg. ”Welcome!”, ”Back at 15.15”

2. HOW-TO Use SMA VIS Instance
This HOW-TO describes how to use a VIS instance deployed by SMA

3. Certificate Revocation Lists
Overview
SMA can provide a VIS instance on Azure cloud server. The VIS instance has a defined private REST interface where your own application can securely connect and retrieve incoming messages (RTZ, TXT, S124), send message and search for services to consume. The VIS instance handles authentication of consumers, validation of incoming data format and supports with secure service-to-service requests on HTTPS.
MCP
Web Portal
Identity Registry
Certificate Revocation Lists
Internet
Service Registry
Microsoft Azure
Customer
application
SMA VIS
STM Module
HMAC
SSL
any VIS
REST
RTZ
RTZ
Ship
Shore centre
Service Provider

4. Different usages of VIS instance
The following slides shows different usages of the SMA VIS instance depending on need.
Use SMA VIS instance to send and receive RTZ messages
Use SMA VIS instance to provide subscription of voyage plans in RTZ format
Use SMA VIS instance to send and receive TXT messages
Use SMA VIS instance to send and receive Navigational Warnings (S124)
Use SMA VIS instance to search for identities and services, and consume any STM service

5. Design of SMA VIS implementation for exchange of RTZ on request
STM Module
VIS Private REST
VIS Public REST
VIS Public REST
POST /callService/{…}
POST /voyagePlans
POST /notification
GET /message
POST /voyagePlans
Bussiness logic and behaviour on public interface shall be the same for all VIS instances based on same service design version
Private side is not mandatory
Business logic on private side is up to each manufactor

6. Design of SMA VIS implementation for exchange of RTZ through subscription
STM Module
VIS Private REST
VIS Public REST
VIS Public REST
POST /publishMessage
POST /voyagePlans
POST /authorizeIdentities
POST /subscription
POST /voyagePlans
POST /notification
GET /voyagePlans
GET /message
POST /voyagPlans/subscription
Bussiness logic and behaviour on public interface shall be the same for all VIS instances based on same service design version
Private side is not mandatory
Business logic on private side is up to each manufactor

7. Complete design of SMA VIS implementation for exchange of TXT
STM Module
VIS Private REST
VIS Public REST
VIS Public REST
POST /callService/{…}
POST /textMessage
POST /textMessage
POST /notification/
GET /message/

8. Complete design of SMA VIS implementation for exchange of S124
STM Module
VIS Private REST
VIS Public REST
VIS Public REST
POST /callService/{…}
POST /area
POST /area
POST /notification/
GET /message/

9. Complete design of SMA VIS implementation SeaSWIM support (SSC)
STM Module
VIS Private REST
VIS Public REST
POST /callService/{…}
MCP
POST /findService{…}
Service Registry
GET /findIdentities{…}
Identity Registry

10. SMA VIS interfaces

11. Procedures, step-by-step
Ask for a VIS instance from SMA In return you’ll get:
URL to private REST interface of the instance
URL to public REST interface of the instance
HMAC details for private secure connection
Register your service instance in Service Registry (MCP STAGING)
You need to register your organization in MCP to get access to Service Registry
Issue service certificates
Download and send the certificates to SMA to be inserted in the service database for use in authentication
Create your application or service, connect to the private REST interface to your VIS instance and start exchanging voyage plans in RTZ format with other services in STM!
When your services has been compliance tested and approved, the service can be registered in MCP PRODUCTION.

12. Specifications
VIS Technical REST Design – SMA private side
HMAC security on SMA VIS private side
RTZ (RTZ FORMAT + STM EXTENSION)
TXT (TEXT MESSAGE FORMAT)
VIS Technical REST Design – SeaSWIM side stmvalidation/uploads/ /VIS-REST-Design-for-SeaSWIM_v2.2.2.pdf
HOW-TO Get started with STM and SeaSWIM
HOW-TO Register the service

13. At the end – you could add text in black like ”Thank You !”