Kieli / Språk / Language: Suomi | Svenska | English
← Takaisin Sataman käyttöohjeen sisällysluetteloon
1.3 Organisaation ylläpito
1.3 Organisaation ylläpito
Organisaation ylläpito on keskitetty näkymä selainkäyttöliittymässä, jossa hallitaan organisaatioon liittyviä tietoja, käyttäjiä, oikeuksia sekä teknisiä ja operatiivisia yhteyksiä muihin toimijoihin ja järjestelmiin.
Pääkäyttäjä (admin) voi tarkastella ja päivittää seuraavia tietoja ja asetuksia:
| Välilehti | Toiminnot |
| Organisaatio | Päivitä perustiedot: nimi, yhteystiedot ja tunnisteet |
| Käyttäjät | Kutsu uusia käyttäjiä ja hallitse käyttöoikeuksia. |
| Käyttöoikeusryhmät | Luo ja hallitse oikeuksia ryhmäkohtaisesti. |
| Kansallinen satama-API | Määritä ja hallitse rajapintayhteyttä järjestelmien välillä. |
Käyttöedellytykset
Organisaation ylläpito on käytettävissä, kun olet kirjautunut Nemoon ja valinnut organisaatiotilin (jos useita) ja sinulla on organisaation pääkäyttäjän (admin) käyttöoikeudet.
Organisaation pääkäyttäjät vastaavat siitä, että organisaation tiedot ja käyttöoikeudet ovat aina ajantasaisia. Nemo ei automaattisesti tunnista virheellisiä tai vanhentuneita tietoja eikä ilmoita niistä käyttäjälle.
Organisaatiotiedot sisältyvät osaksi satamakäynnin ilmoitusten (MAI) otsikkotietoja. Virheelliset tai puutteelliset tiedot voivat aiheuttaa ongelmia ilmoitusten vastaanotossa tai käsittelyssä viranomaisten toimesta.
Näin siirryt organisaation ylläpitoon
avaa päävalikosta Menu-valikko (desktopissa oikea yläkulma, mobiilissa oikea alakulma) ja valitse Organisaation ylläpito
näet oletuksena Organisaatio-näkymän. Siirry eri ylläpitonäkymien välillä tarkastellaksesi organisaation tietoja, käyttäjiä, käyttöoikeusryhmiä ja rajapintayhteyksiä
Muokkaa organisaation tietoja
Tiedot tukevat käyttäjien tunnistamista ja oikeuksien hallintaa, yhteydenpitoa ja viranomaisviestintää sekä organisaatiokohtaista raportointia ja seurantaa.
Organisaation yhteyshenkilö
Organisaatiolle on valittu yhteyshenkilö, joka toimii virallisena kontaktina viranomaisasioinnissa. Yhteyshenkilö:
vastaanottaa Nemosta sähköpostiviestejä esimerkiksi silloin, kun aluksen todistuksen voimassaolo on päättynyt tai satamakäynnin ilmoituksessa ilmenee poikkeama, joka vaatii toimenpiteitä
yhteyshenkilön tiedot tallentuvat lähetetylle ilmoitukselle otsikkotietona (MAI)
Näin muokkaat organisaation tietoja
avaa päävalikosta Menu-valikko ja valitse Yrityksen ylläpito
tarkastele ja muokkaa tarvittavia tietoja Organisaatio-välilehdellä
paina Tallenna, kun muutokset on tehty
näet, että organisaation tiedot ovat tallentuneet
Käyttäjien ylläpito
Pääkäyttäjä voi lisätä ja poistaa käyttäjiä, muuttaa heidän roolejaan ja käyttöoikeusryhmiään sekä määrittää, kuka toimii organisaation yhteyshenkilönä. Yhteyshenkilön tiedot tallentuvat automaattisesti osaksi lähetettyjen satamakäynti-ilmoitusten (MAI) otsikkotietoja. Pidä käyttäjä- ja yhteyshenkilötiedot aina ajan tasalla ennen ilmoitusten lähettämistä.
Käyttäjätyypit
Jokaiselle organisaation käyttäjälle valitaan jompikumpi kahdesta käyttäjätyypistä:
Pääkäyttäjä (admin) — ylläpitää organisaation tietoja, käyttäjiä, käyttöoikeusryhmiä ja rajapintayhteyksiä. Näkee, lisää, muokkaa ja poistaa tietoa käyttöoikeusryhmänsä mukaisesti. Suositeltavaa on, että organisaatiossa on vähintään kaksi pääkäyttäjää toiminnan jatkuvuuden varmistamiseksi.
Jäsen (basic) — näkee, lisää, muokkaa ja poistaa tietoa käyttöoikeusryhmänsä mukaisesti.
Käyttäjätiedot
Jokaisesta käyttäjästä tallennetaan seuraavat tiedot:
| Tieto | Kuvaus |
| Nimi | Tulee automaattisesti Suomi.fi-tunnistautumispalvelusta käyttäjän liittymisen yhteydessä. Nimeä ei voi muokata Nemossa. |
| Sähköposti | Vastaa käyttäjän liittymisen yhteydessä antamaa sähköpostiosoitetta. Käytetään kutsujen ja ilmoitusviestien lähettämiseen. |
| Käyttäjätyyppi | Admin = Pääkäyttäjä, jolla on oikeudet organisaation hallintaan. Voidaan valita yhteyshenkilöksi. Basic = Tavallinen käyttäjä, joka voi tarkastella ja käsitellä tietoja käyttöoikeusryhmänsä mukaisesti. |
| Käyttöoikeusryhmä | ReadWriteAll = Täydet luku- ja muokkausoikeudet kaikkiin organisaation hallinnoimiin tietoihin. PUBLIC = Vain julkiset tiedot nähtävissä, ei muokkausoikeuksia. Omat ryhmät = Organisaatiokohtaiset ryhmät, jotka ylläpitäjä voi määrittää tarpeen mukaan. Suositeltavaa, että jokainen organisaatio luo omat käyttöoikeusryhmiä käyttäjäkohtaisten tiedonsaantioikeuksien mukaisesti. |
| Odottaa käsittelyä | Käyttäjä on kutsuttu organisaatioon, mutta ei ole vielä hyväksynyt kutsua tai viimeistellyt liittymistä. |
Käyttäjän kutsuminen organisaatioon
Pääkäyttäjä voi kutsua uuden käyttäjän organisaatioon antamalla käyttäjätyypin, sähköpostiosoitteen ja käyttöoikeusryhmän. Kutsun lähettämisen jälkeen käyttäjä vastaanottaa sähköpostiin linkin organisaatioon liittymistä varten.
Käyttäjällä on käyttöoikeus vain niihin organisaatioihin, joihin hänet on erikseen kutsuttu — vaikka hän olisi jo käyttäjänä Nemossa.
Näin kutsut käyttäjän organisaatioon
valitse Kutsu käyttäjä
täytä käyttäjätyyppi, käyttöoikeusryhmä ja sähköpostiosoite (tai osoitteet)
paina Kutsu
saat ilmoituksen, joka vahvistaa kutsun lähettämisen
Käyttäjätyypin muuttaminen
Pääkäyttäjä voi muuttaa omaa tai muiden käyttäjien käyttäjätyyppiä. Käyttäjätyyppiä ei voida muuttaa, jos kyseessä on organisaation ainoa pääkäyttäjä.
Käyttäjätyypin muuttuessa myös käyttöoikeudet muuttuvat. Jos muutat oman tyyppisi jäseneksi, et voi enää ylläpitää organisaatiota.
Näin muutat käyttäjätyyppiä
valitse käyttäjä ja muuta käyttäjätyyppiä alasvetovalikosta
saat ilmoituksen, joka vahvistaa käyttäjätyypin päivityksen
Käyttöoikeusryhmän muuttaminen
Pääkäyttäjä voi muuttaa omaa tai muiden käyttäjien käyttöoikeusryhmää. Käyttöoikeusryhmä määrittää, mihin tietoihin käyttäjällä on pääsy.
Näin muutat käyttäjän käyttöoikeusryhmää
valitse käyttäjä ja muuta käyttöoikeusryhmä alasvetovalikosta
saat viestin, joka vahvistaa käyttäjätietojen päivityksen
Käyttäjän poistaminen organisaatiosta
Pääkäyttäjä voi poistaa käyttäjän organisaatiosta. Poistetun käyttäjän pääsy organisaation tilille päättyy välittömästi.
Näin poistat käyttäjän
valitse käyttäjä ja paina poistamispainiketta
vahvista poisto
saat viestin, joka vahvistaa käyttäjän poistamisen
Poistuminen organisaatiosta
Pääkäyttäjä voi poistaa itsensä organisaatiosta. Tämä poistaa kaikki oikeudet kyseiseen organisaatioon, mukaan lukien ylläpito-oikeudet. Poistuminen ei onnistu, jos olet organisaation ainoa pääkäyttäjä.
Poistuminen tapahtuu samalla tavalla kuin muiden käyttäjien poistaminen: valitse oma nimesi käyttäjälistalta ja seuraa ohjeita kohdassa Käyttäjän poistaminen organisaatiosta.
Käyttöoikeusryhmien ylläpito
Käyttöoikeusryhmä määrittää, mitä tietoja ja toimintoja käyttäjä voi käyttää Nemossa ja millä laajuudella. Jokaiselle käyttäjälle valitaan käyttöoikeusryhmä, kun hänet kutsutaan organisaatioon.
Käyttöoikeusryhmiä on kahdenlaisia:
Omat käyttöoikeusryhmät — organisaation pääkäyttäjä voi luoda, muokata ja poistaa näitä ryhmiä tarpeen mukaan.
Yleiset käyttöoikeusryhmät — esimääritellyt ryhmät, jotka ovat heti käytettävissä ja voidaan liittää suoraan käyttäjille. Ei voida poistaa.
Siirry Käyttöoikeusryhmät-välilehdelle Yrityksen ylläpidossa.
Yleiset käyttöoikeusryhmät
| Nimi | Sisältää |
|---|---|
| Julkiset satamakäyntitiedot | Käyttäjä voi hakea ja tarkastella aluksia niiden saapumis- ja lähtöaikojen perusteella Julkiset satamakäyntitiedot -näkymässä. |
| Lue ilmoituksia, lähetä delegoidut ilmoitukset | Käyttäjä voi:
|
| Lue ilmoituksia | Käyttäjä voi:
|
Näin luot oman käyttöoikeusryhmän
paina Luo käyttöoikeusryhmä
täytä ryhmän nimi ja valitse käyttöoikeudet
paina Tallenna
Näet luodun käyttöoikeusryhmän
Näin muokkaat omaa käyttöoikeusryhmää
valitse oma käyttöoikeusryhmä
muokkaa ryhmän nimeä ja/tai valittuja käyttöoikeuksia
paina Tallenna
näet, että käyttöoikeusryhmä on päivitetty
Näin poistat oman käyttöoikeusryhmän
valitse poistettava oma käyttöoikeusryhmä
paina poistamispainiketta
vahvista poisto
näet, että käyttöoikeusryhmä on poistettu eikä se enää näy listassa
tarkasta käyttäjien käyttöoikeusryhmä, mikäli juuri poistettu ryhmä on poistunut käyttäjältä
Kansallisen satama API-rajapinnan käyttö
Kansallinen satama API-rajapinta mahdollistaa satamakäynteihin liittyvien ilmoitusten tarkastelun, lähettämisen Nemoon, ilmoitusten vastaanottamisen sekä satama statistiikan välittämiseen viranomaisille. Rajapinta hyödyntää REST-protokollaa ja JSON-formaattia.
Käyttöönottoon tarvitset:
Organisaatiotilin Nemossa
Pääkäyttäjän oikeudet, jotta pääset API-välilehdelle
API tiedot, tunnistautumista varten
Satama-API
Valitse satama-API, kun organisaatiosi on satamatoimija, joka valvoo ja hallinnoi satama-alueen toimintaa. Rajapinnan avulla voit ladata tilastotietoja sekä hakea saapumis-, lähtemis- sekä alustietoja REST-protokollaa hyödyntäen.
Siirry sanomaoppaan teknisiin Port API -ohjeisiin: Integroi Suomen Maritime Single Window -palveluun (NEMO) – National API - Port API
Data Service Providerin (DSP) käyttö
Satamaorganisaatio voi käyttää ulkopuolista Data Service Provideria (DSP) teknisen rajapintaintegraation toteuttamiseen ja NEMOn tietojen hakemiseen organisaation puolesta.
DSP toimii aina satamaorganisaation valtuuttamana palveluntarjoajana. DSP:lle ei muodosteta automaattisesti omaa pääsyä satamaorganisaation tietoihin Nemossa, eikä DSP voi itse pyytää tai muodostaa satamaorganisaation API-tunnuksia.
Jos satamaorganisaatio käyttää DSP:tä, satamaorganisaation tulee:
olla rekisteröitynä Nemoon
ottaa käyttöön organisaatiolleen tarvittava API-yhteys ja muodostaa sitä varten asiakastunniste (Client ID) ja salausavain (Client Secret)
toimittaa tarvittavat API-tunnukset käyttämälleen DSP:lle turvallisella tavalla
huolehtia tunnusten ylläpidosta, uusimisesta ja tarvittaessa niiden poistamisesta
DSP käyttää rajapintaa satamaorganisaatiolle myönnetyillä tunnuksilla ja toimii tällöin kyseisen organisaation puolesta. Vastuu API-yhteyden ja siihen liittyvien tunnusten hallinnasta säilyy satamaorganisaatiolla.
Jos Client Secret katoaa, paljastuu tai DSP:n käyttö päättyy, satamaorganisaation tulee uusia tai poistaa API-yhteyden tunnukset Nemossa.
Asiakastunniste ja salausavain
Asiakastunniste tunnistaa organisaation, joka käyttää API-yhteyttä. Muodosta yhteys painamalla Luo yhteys. Yhteyttä ei voi muuttaa manuaalisesti.
Salausavain toimii kuten salainen avainpari asiakastunnisteen rinnalla. Sitä käytetään API-kutsujen autentikointiin.
Jos salausavain katoaa, vuotaa tai sen turvallisuus vaarantuu, API-yhteys on poistettava ja luotava uudelleen, jolloin muodostuu uusi salausavain.
Milloin tarvitaan uusi salausavain?
Uusi salausavain on luotava esimerkiksi seuraavissa tilanteissa:
organisaatiossa vaihdetaan integraatiojärjestelmä tai palvelin, joka käyttää API-yhteyttä
nykyinen salausavain on kadonnut tai sitä ei enää löydy järjestelmästä
epäillään, että salausavain on paljastunut tai väärinkäytös
API-yhteys poistetaan ja luodaan uudelleen (esim. konfiguraation muutosten vuoksi)
Näin otat käyttöön kansallisen API-ilmoittajarajapinnan
avaa päävalikosta Menu-valikko ja valitse Yrityksen ylläpito
avaa API-välilehti
paina Luo yhteys
API-yhteys luotu ja tiedot (Asiakastunniste ja Salausavain) näkyvät
Näin uusit salausavaimen kansalliselle API-rajapinnalle
avaa API-välilehti.
valitse Luo uusi salausavain
paina Tallenna, kun muutokset on tehty.
Kansallisen API-rajapinnan poistaminen
Jos kansallinen API-rajapintayhteys ei ole enää tarpeen, organisaation pääkäyttäjä voi poistaa sen. Poistamisen jälkeen ilmoitusten lähettäminen API:n kautta ei onnistu, joten organisaation on otettava käyttöön jokin toinen käyttötapa (käyttöliittymä tai RIM-rajapinta).
Näin poistat kansallisen API-rajapinnan
avaa API-välilehti
paina Poista rajapintayhteys
vahvista API:n poistaminen