Kynning
API lyklar veita utanaðkomandi forritum aðgang að Manor API. Með þeim er hægt að tengja annan hugbúnað, samstilla fjárhags- eða verkefnagögn, gera endurtekin verk sjálfvirk og smíða eigin samtengingar. API lyklar veita forritum aðgang að Manor stofunni þinni. Því er mikilvægt að meðhöndla þá á öruggan hátt og úthluta viðeigandi hlutverkum.
Reitir lykla
Þegar þú skoðar eða stillir API lykla sérðu eftirfarandi reiti:
- Nafn: Lýsandi heiti á API lyklinum (t.d. „Power BI skýrslur“ eða „Bókhaldstenging“). Nafnið segir til um hvaða þjónusta eða samtenging notar lykilinn.
- Notandi: Kerfisnotandinn sem er tengdur API lyklinum. Lykillinn fær allar heimildir sem kerfisnotandinn hefur. Aðeins er hægt að gefa út API lykla fyrir kerfisnotendur, ekki venjulega notendur.
- Lykill: Einkvæmt auðkenni sem birtist í listanum. Með því er hægt að tengja kerfisbeiðnir eða færslur í atburðaskrá við tiltekinn lykil án þess að leynilykillinn sjálfur komi fram.
- Rennur út: Valfrjáls dagsetning þegar API lykillinn rennur sjálfkrafa út. Eftir það geta utanaðkomandi forrit ekki lengur auðkennt sig með lyklinum.
- Lýsing: Valfrjáls athugasemd um til hvers lykillinn er notaður, hvaða umhverfi hann tengist eða hvaða teymi ber ábyrgð á honum.
- Staða: Núverandi staða lykilsins, annaðhvort Virkur eða Afturkallaður [dagsetning].
- Stofnað: Dagsetningin þegar API lykillinn var stofnaður.
Stofna nýjan API lykil
Mikilvægt: Leynilykillinn birtist aðeins einu sinni, strax eftir að hann er stofnaður. Af öryggisástæðum birtir Manor hann aldrei aftur. Afritaðu lykilinn og geymdu hann í öruggum lykilorðastjóra eða leynigeymslu áður en þú lokar glugganum.
Svona stofnar þú API lykil:
-
Farðu í Kerfisstjórn → API lyklar í hliðarvalmyndinni.
-
Smelltu á hnappinn Stofna lykil efst til hægri.
-
Sláðu inn lýsandi Nafn (skylda).
-
Veldu kerfisnotanda í fellilistanum Notandi (skylda).
Athugaðu: Ef enginn kerfisnotandi er til skaltu fara í Kerfisstjórn → Notendur og smella á Stofna kerfisnotanda fyrir samtengingu kerfa. Kerfisnotendur nota ekki venjuleg notendaleyfi og hækka ekki áskriftargjöld.
-
Veldu dagsetningu í Rennur út ef lykillinn á að renna út (valfrjálst).
-
Sláðu inn Lýsingu á því til hvers lykillinn er notaður (valfrjálst).
-
Smelltu á Vista.
-
Nýi lykillinn birtist í staðfestingarglugga. Afritaðu hann strax.
-
Smelltu á afritunarhnappinn til að afrita lykilinn á klippiborðið. Geymdu hann á öruggum stað og lokaðu síðan glugganum.
Stjórna API lyklum
Á yfirlitssíðunni API lyklar getur þú fylgst með lyklum, breytt þeim og afturkallað þá.
Finna API lykla
Sláðu inn nafn, kerfisnotanda eða lykil í leitarreitinn Hraðleit fyrir ofan töfluna. Listinn síast um leið og þú skrifar.
Breyta API lykli
- Smelltu á línu API lykilsins sem þú vilt breyta.
- Breyttu Nafni, Rennur út eða Lýsingu í glugganum Breyta lykli eftir þörfum.
- Smelltu á Vista.
Afturkalla API lykil
Afturkallaðu lykil strax ef hann hefur komist í rangar hendur, verið tekinn úr notkun eða samtengingin þarf hann ekki lengur:
- Smelltu á línu virka lykilsins til að opna gluggann Breyta lykli.
- Smelltu á rauða hnappinn Afturkalla lykil neðst til vinstri.
- Smelltu á Staðfesta í staðfestingarglugganum.
Afturkallaður lykill hættir strax að taka við beiðnum og staða hans verður Afturkallaður [dagsetning]. Ekki er hægt að virkja afturkallaðan lykil aftur.
Góðar venjur
- Lágmarksréttindi: Gefðu kerfisnotendum API lykla aðeins þau hlutverk sem samtengingin þarf til að virka.
- Sérstakur lykill fyrir hverja þjónustu: Stofnaðu sérstakan API lykil og kerfisnotanda fyrir hvert tól eða þjónustu. Þá er auðveldara að rekja notkun, og hægt er að afturkalla aðgang eins tóls án þess að það hafi áhrif á önnur.
- Notaðu gildistíma: Settu dagsetningu í Rennur út fyrir aðgang utanaðkomandi forritara og prufutengingar. Þannig verða gleymdir lyklar ekki opnir endalaust.
- Endurnýjaðu lykla reglulega: Stofnaðu nýja lykla með reglulegu millibili, uppfærðu utanaðkomandi þjónustur og afturkallaðu gömlu lyklana.
- Deildu aldrei lyklum í opnum texta: Geymdu lykla aðeins í öruggum leynigeymslum eða stillingarskrám umhverfis. Settu þá aldrei í útgáfustýringu eða spjallrásir teymisins.