Nuper interSystems API Procurator (IAM) novam compositionem interSystems IRIS datam in rostris dimisisti, quae visibilitatem, imperium, ac administrationem interretialem API traiectionis per IT infrastructuram praebet.
In hoc articulo tibi demonstrabo quomodo IAM constituas et nonnullas facultates quae tibi cum IAM praesto sint demonstrabo. InterSystems API Procurator te permittit:
- Monitor API, intellige qui utitur API, qui APIs popularis, et quae emendationem requirunt.
- Imperium, qui API ac limite usus API utitur a restrictionibus simplicibus accessus ad restrictiones petendi-substructio - consuetudo temperantiae habes et cito respondere potest ad exemplaria API mutanda consummatio.
- Securus APIs utens machinationes securitatis centralesed ut OAuth2.0, LDAP vel Clavis Thochen Authenticatio.
- Facilius pro tertia parte tincidunt et superiori API experientiam illis praebent aperiendo dedicatam elit portal.
- Ascendite API et minimam responsionem latency ensure.
API procuratio essentialis est transitus ad architecturae SOA vel parvae servitutis, simplificans integrationem inter singula officia (micro) opera, quae praesto sunt omnibus sumptis externis et internis. Quam ob rem novae APIs faciliores fiunt ad creandum, conservandum, et consumendum.
Si iam interSystems IRIS uteris, optionem IAM ad licentiam tuam addere potes. IAM optio libera est pro clientibus interSystems IRIS, sed novam clavem licentiae ab InterSystems petere debes ut IAM incipias.
Si interSystems IRIS nondum uteris et InterSystems API Procurator tentare moliris, interSystems pete, pete.
Incipere et instruitur
InterSystemi clientes IAM distributionem e loco posito destruere possunt section "Software Distribution" and run as Docker continentis. Ratio minima requisita:
- 17.04.0.
- 1.12.0.
- InterSystems IRIS 2019.1.1+.
Initio, debes imaginem Docker excutere (Important! Archivum cum WRC non est imago Docker, necesse est ut eam solvas, imago intus est);
docker load -i iam_image.tarHoc mandatum faciet IAM imaginem promptam pro postea usui tuo servo tuo. IAM continens ut separatum decurrit, ut ab interSystemis IRIS independenter conscendere possis. Currens IAM aditum ad InterSystems IRIS requirit ut licentiam accipias.
InterSystema IRIS constitue:
- Admitte applicationem interretialem
/api/IAM - Admitte user
IAM - Mutatio user password
IAM
Iam continens IAM incipiamus. In archivo scripta invenies iam-setup pro Fenestra et Unix (et Mac). Haec scripta adiuvabunt ut variabiles ambitus recte constituas, sino IAM continens nexum cum IRIS interSystems constituere. Exemplum scriptionis in Mac currentis est:
source ./iam-setup.sh
Welcome to the InterSystems IRIS and InterSystems API Manager (IAM) setup script.
This script sets the ISC_IRIS_URL environment variable that is used by the IAM container to get the IAM license key from InterSystems IRIS.
Enter the full image repository, name and tag for your IAM docker image: intersystems/iam:0.34-1-1
Enter the IP address for your InterSystems IRIS instance. The IP address has to be accessible from within the IAM container, therefore, do not use "localhost" or "127.0.0.1" if IRIS is running on your local machine. Instead use the public IP address of your local machine. If IRIS is running in a container, use the public IP address of the host environment, not the IP address of the IRIS container. xxx.xxx.xxx.xxx
Enter the web server port for your InterSystems IRIS instance: 52773
Enter the password for the IAM user for your InterSystems IRIS instance:
Re-enter your password:
Your inputs are:
Full image repository, name and tag for your IAM docker image: intersystems/iam:0.34-1-1
IP address for your InterSystems IRIS instance: xxx.xxx.xxx.xxx
Web server port for your InterSystems IRIS instance: 52773
Would you like to continue with these inputs (y/n)? y
Getting IAM license using your inputs...
Successfully got IAM license!
The ISC_IRIS_URL environment variable was set to: http://IAM:****************@xxx.xxx.xxx.xxx:52773/api/iam/license
WARNING: The environment variable is set for this shell only!
To start the services, run the following command in the top level directory: docker-compose up -d
To stop the services, run the following command in the top level directory: docker-compose down
URL for the IAM Manager portal: http://localhost:8002Ut videre potes, plenum nomen imaginis, IP inscriptio, InterSystems IRIS portum et tesseram IAM usoris omnes incipias oportet.
Loco currens scriptionis, ambitus variabilium manualium constituere potes:
ISC_IAM_IMAGE=intersystems/iam:0.34-1-1
ISC_IRIS_URL=http://IAM:<PASS>@<IP>:<PORT>/api/iam/licenseΠΠ°ΠΏΡΡΠΊ
Nunc IAM percurramus mandatum:
docker-compose up -dHoc mandatum IAM continentia ordinat et efficit ut omnia recte currant. Status continentiae per mandatum inhibetur;
docker psAperi admin interface in navigatro tuo localhost:8002.
Nunc inanis est, quia nodi omnino novi est. Mutandum illud. IAM notionem operum spatiorum sustinet ad APIs dividendum in modulos et/vel imperata. Vade ad spatium "default" quo experimentis nostris utemur.
Numerus petitionum huius workspace adhuc nulla est, sed notionem fundamentalium conceptuum IAM in menu a sinistris habebis. Duo priora elementa: Officia et Itinera principalia sunt;
- API Servitium est cui aditus consumers velimus praebere. Sic CETERA API in InterSystemis IRIS servitii est, ut est, exempli gratia, Google API si ea uti velis.
- Iter decernit cui servitii petitiones advenientes transmittantur. Quaelibet Iter habet peculiares condiciones condiciones, quae si occurrant, petitio mittitur ad debitam servitutem. Exempli gratia, iter itineris potest aequare IP, mittente dominico, modos HTTP, partes URI, vel horum exemplorum compositionem.
obsequium
InterSystema IRIS servitii creemus, cum valoribus sequentibus:
agri
valorem
Description
nomine
Iris
Nomen servitii
exercitum
IP
InterSystems IRIS servo exercitui vel ip
portum
52773
InterSystems IRIS server web port
semita
/api/atelier
Radix semita
protocol
http
protocol
Relinquere reliquas valores ut defaltam. Click a button Create et scribe ID servitii creati.
route
Nunc iter faciamus:
agri
valorem
Description
semita
/api/atelier
Radix semita
protocol
http
protocol
service.id
dux ab III "
Service (ID ex prior gradus)
Relinquere reliquas valores ut defaltam. Click a button Create et scribe ID viae creati. Defalta, IAM auscultat petitiones advenientes in portum 8000. Nunc petitiones missae sunt http://localhost:8000 et incipiens cum /api/atelier determinantur ad InterSystems IRIS.
temptationis
Sit scriptor experiri partum petentibus requiem clientis (Im 'usura ).
Mittamus ad GET petitionem http://localhost:8000/api/atelier/ (noli oblivisci / in fine) et responsionem accipiunt ab InterSystemis IRIS. Quaeque petitio percurrit IAM quae metrice colligit:
- HTTP status code.
- Mora.
- Cras (si felis).
Pauculas postulavi (including duas petitiones ad terminos non existentes sicut /api/atelier/est/), eventus statim visibiles in ashboardday:
Operantes cum plugins
Nunc quod figuram habemus itineris, API tractare possumus. Notas addere possumus quae ministerium nostrum complent.
Via frequentissima API mores mutandi plugin est addere. Plugins singulas functiones segregare et coniungi possunt cum IAM vel globaliter vel tantum cum singulis entibus, sicut User (coetus usorum), Service vel Route. Incipiemus addendo Rate Limiting plugin in Route. Ad nexum inter plugin et iter constituendum, singulari identificatorio (ID) itineris opus est.
Limitandi numerus petitionum
Click Plugins in the left sidebar menu. Potes videre omnia plugins activae in hoc velo, sed quia hic IAM novus est, plugins adhuc activae non sunt. Itaque ad gradum proximum progredi strepitando βNew Pluginβ.
Plugin opus est in categoria "Traffic Control" et vocatur "Rate Limiting". Lego igitur. Paucis fundis hic potes, sed solum duos agros curamus;
agri
valorem
Description
route_id
ID
Iter id
config.minute
5
Multis petitionibus per minute
Id omne. Plugin configuratur et active. Nota quod tempora diversa eligere possumus, ut minutam, horam vel diem. Loca coniungi possunt (exempli gratia petitiones 1000 per horam et simul 100 petitiones per minutias). Minuta delegi quia eam facilem facit ut plugin functionem reprimat.
Si eandem petitionem iterum in Postman mittas, videbis responsionem cum 2 additis capitis remitti;
- XRateLimit-Limit-minute: 5
- XRateLimit-Reliquis-minute: 4
Hoc clienti narrat quod ad 5 petitiones per minutias facere potest et 4 plures petitiones in praesenti temporis socors facere.
Si eandem petitionem iterum atque iterum petis, tandem ex promptu habebis numerum et HTTP statum codicem 429 recipies cum sequenti corpore responsionis:
Exspecta paulisper et petitiones iterum submittere poteris.
Haec mechanismus opportuna est quae te permittit;
- Inundat ab onere defendat backend.
- Dicite clientes quot petitiones facere possunt.
- Monetize in API.
Valores diversis temporis intervallis potes ponere et sic API negotiatio per certum temporis spatium extendere. Dicamus te per DC petitiones per horam in certo itinere permittere. In mediocris sunt petitiones 600 per minutias. Sed nihil prohibet clientem omnes 10 petitiones primo momento horae complere. Forsitan id quod debes. Plus etiam onerare velis decursu horae. Per agrum valorem profecta config.minute Valor 20 efficit ut usores tuos non plus quam XX petitiones per minutias et 20 petitiones per horam efficiant. Hoc permittit spicis parvis in uno minuto intervallo comparato ad plene averaged profluvium 600 petitionum per minutias, sed utentes non possunt horae quota unius momentis uti. Nunc indigebunt saltem 10 minutis suis omnibus petitionibus utendi. Clientes additicii capitis pro unoquoque tempore definito accipient, exempli gratia:
HTTP Header
valorem
X RateLimit-Limit-hora
600
X-RateLimit-Reliquis horae
595
X RateLimit-Limit-minute
20
X-RateLimit, Reliquis-minute
16
Nimirum multi modi sunt configurare limites interrogationis secundum quod vis consequi.
Inventiones
Hic perficiam, satis materiam puto primi articuli de InterSystems API Procurator. Tantum unum e plus quam 40 plugins usus est. Sunt plura interesting quae cum IAM facere potes:
- Adde mechanismum authenticum centrale pro omnibus tuis APIs.
- Ascendite onus utens onere librario per multa Services.
- Novam functionalitatem adde et cimex in auditorio experiendi antequam plenam renovationem figat.
- Tincimenta interna et externa praebent cum dedicatis documentis portalibus omnibus APIs.
- Cache postulat ut responsio tempus minuat et onus in systematis backend reducat.
References
webinar
Te invitamus ad telaris "API Management cum InterSystems API Management", quod fiet die 21 mensis Novembris tempore 10:00 Moscuae (GMT+3).
InterSystema API Procurator (IAM) est nova pars interSystems IRIS Data Platform quae vigilantia, moderatio et administratio negotiationis praebet ad/e tela APIs intra IT infrastructuram. In webinar demonstrabimus facultates keys InterSystems API Management:
- API instrumenta negotiationis magna.
- API negotiatio controllata, inclusa bande potestate, numerum API limitans vocat, tabulas permissas et negatas tabulas inscriptionum IP servans, etc.
- Configuratio instrumentorum securitatis API.
- Elit porta pro evulgandi documenta interactive API.
- Uno loco aditus ad API.
Webinar destinatur architectis, tincidunt et administratoribus ratio.
!
Source: www.habr.com