
ãã¡ã€ã¢ãŠã©ãŒã«ã®å åŽã«ããAPIãè² è·ãã¹ãããæ¹æ³
æ¬èšäºã¯2026/10/26ã«å ¬éããã以äžã®èšäºã®æ¥æ¬èªçã§ã
How to load test an API behind a firewall
æ©èœãã¹ãã¯ãã©ã®ãã«ãã§ãæåããŸãããšããããã¹ããŒãžã³ã°ç°å¢ã«å¯ŸããŠè² è·ãã¹ããå®è¡ãããšã403ãšã©ãŒã倧éã«è¿ã£ãŠããŸãããã¡ã€ã¢ãŠã©ãŒã«ããè² è·çæãã·ã³ã®IPã¢ãã¬ã¹ãäžåºŠãèŠãããšããªãããã§ãã
ãã¡ã€ã¢ãŠã©ãŒã«ã®å åŽã«ããAPIãè² è·ãã¹ãããã«ã¯ããªã¢ãŒãã®IPããè² è·ããããè² è·çæãã·ã³ã«å¯ŸããŠããšã³ããã€ã³ããå°éå¯èœã«ãªã£ãŠããå¿ èŠããããŸãããã®ããã«ã¯ãèš±å¯ãªã¹ãã«ç»é²ã§ããéçIPã¢ãã¬ã¹ã®åºå®ã®äžèЧãããè² è·ãéä¿¡ããã®ãæãŸããæ¹æ³ã§ããããããã°ããŸãä¿¡é Œã§ãããã·ã³ã§ãã¹ããæ€èšŒãããã®ããã§èš±å¯ãªã¹ãç»é²æžã¿ã®éä¿¡å ããã¹ã±ãŒã«ã¢ãŠãã§ããŸãã
å®è¡å ã¯ããŒã¿ç°å¢ãã¹ããŒãžã³ã°ç°å¢ã«ããŠãæ¬çªã®ãã©ãã£ãã¯ã§ããã«ããã¯ãçºèŠããåã«ããªãªãŒã¹ã®é¢éãšããŠäœ¿ããŸãã
ãªãè² è·ãã¹ãã§ãã¡ã€ã¢ãŠã©ãŒã«ãé害ã«ãªãã®ã
ãã§ãã¯ã¢ãŠãAPIãæ åœããããŒã ãäŸã«èããŸããã«ãŒã«ã¯ã·ã³ãã«ã§ããåæãŠãŒã¶ãŒ500äººã®æç¹ã§ã90ããŒã»ã³ã¿ã€ã«ïŒp90ïŒã®ã¬ã€ãã³ã·ãŒã500ããªç§æªæºããšã©ãŒçã1%æªæºã§ããããšã§ããã¹ããŒãžã³ã°ããã®åºæºãæºãããªããã°ããã®ãã«ãã¯æ¬çªã«é²ã¿ãŸããã
ãã®å Žåããããã¯ãŒã¯ã®å¶éãæãå³ããã¹ããŒãžã³ã°ç°å¢ã®ã€ã³ãã©ã«å¯ŸããŠãè² è·ãã¹ããå®è¡ããããšã«ãªããŸããstaging-api.example.comã«ã¯ãããªãã¯ã¢ãã¬ã¹ããããŸãããWebã¢ããªã±ãŒã·ã§ã³ãã¡ã€ã¢ãŠã©ãŒã«ïŒWAFïŒãèš±å¯ããã®ã¯ã瀟å ãããã¯ãŒã¯ãšãç¶ç¶çã€ã³ãã°ã¬ãŒã·ã§ã³ïŒCIïŒã©ã³ããŒã®ãããã¯ãŒã¯ã¢ãã¬ã¹å€æïŒNATïŒã²ãŒããŠã§ã€ã ãã§ãããã以å€ã¯ãã¹ãŠ403ãè¿ããŸãã
æ©èœãã¹ãã¯ãèš±å¯ãªã¹ãã«ç»é²ãããCIã©ã³ããŒããå®è¡ããããããåé¡ãªãéããŸããããã¯Postmanã®Private Runnerãšåã圢ã§ããåé¡ã¯è² è·ãã¹ãã§ããCIã©ã³ããŒ1å°ã§ã¯500ä»®æ³ãŠãŒã¶ãŒãçæã§ããŸãããããšãã£ãŠãã¯ã©ãŠãã®è² è·çæãã·ã³ã¯ãWAFãèŠãããšã®ãªãã¢ãã¬ã¹ãããã©ãã£ãã¯ãéä¿¡ããŸãã
ãã¡ã€ã¢ãŠã©ãŒã«ãè¶ããŠè² è·ããããäžè¬çãªæ¹æ³
äžè¬çãªæ¹æ³ã¯4ã€ãããããããã«é©ããç¶æ³ããããŸãã

APIã«ãããªãã¯ã¢ãã¬ã¹ããŸã£ãããªãå Žåã¯ãã»ã«ããã¹ããé©åãªéžæè¢ã§ããããããã¯ããã«äžè¬çãªããšã³ããã€ã³ãã¯å ¬éãããŠãããéä¿¡å IPã§ãã£ã«ã¿ãªã³ã°ãããŠããã±ãŒã¹ã§ã¯ã2ã€ãå¿ èŠã§ãããããŒãžããªã€ã³ãã©ããè² è·ãçæããããšãšãçãå®å®ããéä¿¡å ã¢ãã¬ã¹ã®äžèЧã§ãã
ãã¡ã€ã¢ãŠã©ãŒã«ã®å åŽã«ããAPIãè² è·ãã¹ãããæé
以éã§ã¯ããã§ãã¯ã¢ãŠãããŒã ã®CollectionãäŸã«ãPostmanã§ã®èšå®æé ã説æããŸããPostmanã®ããã©ãŒãã³ã¹ãã¹ãã¯ãæ©èœãã¹ãã§äœ¿ãã®ãšåãCollectionããå®è¡ãããŸãããªã¯ãšã¹ãã®é åºãpre-requestã¹ã¯ãªãããšpost-responseã¹ã¯ãªãããpm.test()ã®ã¢ãµãŒã·ã§ã³ã¯ã1åã ãå®è¡ããå Žåãšåãããã«ãè² è·ãããã£ãç¶æ ã§ãåäœããŸãã
1. ãã§ã«ããCollectionããå§ãã
ãã®Collectionã¯ããµã€ã³ã€ã³ããã«ãŒãã«ååã远å ããæ³šæã確å®ããŸããåãªã¯ãšã¹ãã«ã¯ããã§ã«ã¢ãµãŒã·ã§ã³ãå«ãŸããŠããŸãã
pm.test("order is created", () => {
pm.response.to.have.status(201);
});
è² è·ãã¹ãçšã®å¥ã¹ã¯ãªããã¯å¿ èŠãããŸããã
2. ããŒã«ã«ã§ã¹ã¢ãŒã¯ãã¹ããè¡ã
ã¯ã©ãŠãã®å®¹éã«ã³ã¹ãããããåã«ããã¹ãèªäœã«åé¡ããªãããšã確èªããŸããCollection Runnerã§ãRun typeãPerformanceãRun methodãAppã«èšå®ãã10ã20ä»®æ³ãŠãŒã¶ãŒã§æ°åéå®è¡ããŸããã¿ãŒããã«ããåã確èªãè¡ãå Žåã¯ã次ã®ããã«ãªããŸãã
postman performance run <collection-id> --peak-vu 20 --duration 3 --load-profile fixed --pass-if "less_than(p90, 500)"
å®è¡äžã¯ãã·ã¹ãã ã¡ããªã¯ã¹ã芳å¯ããŠãã ãããCPUãäžéã«è¿ãå Žåã衚瀺ãããã¬ã€ãã³ã·ãŒã®äžéšã¯ãããŒãPCã®æ§èœã«èµ·å ããŠããŸããããã§ã®ç®çã¯ãå£ãã倿°ã倱æããã¢ãµãŒã·ã§ã³ãæããã«é ããšã³ããã€ã³ããèŠã€ããããšã§ããããã£ãã·ãã£ã枬å®ããããšã§ã¯ãããŸããããã¹ããããŒãPCããã¯ã©ãŠãã«ç§»ãæ¹æ³ã«ã€ããŠã¯ãã¯ã©ãŠãããã©ãŒãã³ã¹ãã¹ãïŒããŒãPCããCIãŸã§ãåç §ããŠãã ããã
3. Postmanã®IPãèš±å¯ãªã¹ãã«ç»é²ãã
ã»ãã¥ãªãã£ããŒã ã«äŸé ŒããŠãã¹ããŒãžã³ã°ãä¿è·ããŠããWAFã«ãŒã«ãŸãã¯ã»ãã¥ãªãã£ã°ã«ãŒãã«ãPostmanã®éçIPã¢ãã¬ã¹ã远å ããŠããããŸããã¢ãã¬ã¹ã¯ãPostmanã¢ã«ãŠã³ãã®ãªãŒãžã§ã³ïŒããã©ã«ãã¯ç±³åœãEU Data Residencyãã©ã³ã§ã¯EUïŒã«ãã£ãŠç°ãªããŸããäžèЧã¯å€æŽãããå¯èœæ§ããããããæ¬èšäºã§ã¯ãªããããã©ãŒãã³ã¹ãã¹ãã®ããã¥ã¡ã³ãã®éçIPã®ã»ã¯ã·ã§ã³ãããã䜿ãã®ãªãŒãžã§ã³ã®ææ°ã®äžèЧãã³ããŒããŠãã ããã
è² è·ã¯ããããŸã§ã©ããPostmanã®ã¯ã©ãŠãã€ã³ãã©ããéä¿¡ãããŸããèš±å¯ãªã¹ãã«ç»é²ããã®ã¯ããã®éä¿¡å ã¢ãã¬ã¹ã ãã§ããããã¯ãŒã¯å ã«äœããã€ã³ã¹ããŒã«ããå¿ èŠã¯ãããŸããã
4. éçIPã䜿ã£ãŠPostman Cloudã§å®è¡ãã
Run methodãCloudã«åãæ¿ããŸããä»®æ³ãŠãŒã¶ãŒæ°ã500ã«èšå®ããè² è·ãããã¡ã€ã«ã¯Ramp upãéžãã§ãããŒã¯ã«éããåã«APIããŠã©ãŒã ã¢ãããããããã«ããããã§ãå®è¡æéãèšå®ããŸããEgress routing strategyã§Static IPsãéžæããPass test ifã«p90 less than 500ãèšå®ããŸãã

ã¯ã©ãŠãã®ããã©ãŒãã³ã¹ãã¹ãå®è¡ã§ãEgress routing strategyã«Static IPsãéžæãã
Postmanã¯ããããŒãžããªã¯ãŒã«ãŒã«è² è·ã忣ãããããä»®æ³ãŠãŒã¶ãŒæ°ã1å°ã®ãã·ã³ã«å¶éãããããšã¯ãããŸãããã¡ããªã¯ã¹ããšã©ãŒãã¢ãµãŒã·ã§ã³ã®çµæã¯ãå®è¡äžã«ã¹ããªãŒãã³ã°ã§è¡šç€ºãããŸããæåã®1åã§æãããªç°åžžãèŠã€ãã£ãå Žåã¯ãäžèŠãªä»®æ³ãŠãŒã¶ãŒïŒVUïŒæéã®æéãçºçããªããããå®è¡ã忢ããŠãã ãããå®äºããã¬ããŒãã¯ã¯ãŒã¯ã¹ããŒã¹ã«ä¿åããããããããŒã ã®èª°ã§ãããšããéããŸãã
5. CI/CDã§ãªãªãŒã¹ã®é¢éã«ãã
ã¯ã©ãŠãå®è¡ãåé¡ãªãå®äºããããåããã¹ãããã€ãã©ã€ã³ã«çµã¿èŸŒã¿ãŸãã--runner postman-cloud-static-ipãªãã·ã§ã³ã§ãéçIPã¢ãã¬ã¹ããè² è·ãéä¿¡ãã--pass-ifã§çµäºã³ãŒããæ±ºå®ããŸãã
name: Staging performance gate
on:
push:
branches: [main]
jobs:
performance:
runs-on: ubuntu-latest
timeout-minutes: 45
steps:
- name: Install Postman CLI
run: curl -o- "https://dl-cli.pstmn.io/install/linux64.sh" | sh
- name: Sign in to Postman
run: postman login --with-api-key ${{ secrets.POSTMAN_API_KEY }}
- name: Run performance test from static IPs
run: |
postman performance run "${{ vars.COLLECTION_ID }}" \
--runner postman-cloud-static-ip \
--peak-vu 500 \
--duration 30 \
--pass-if "less_than(p90, 500)"
ã³ãã³ãã¯ã¯ã©ãŠãå®è¡ãçµäºãããŸã§åŸ æ©ãããããå€ãæºãããªããã°ããŒã以å€ã®çµäºã³ãŒãã§çµäºããŸããããã«ãããžã§ãã倱æãããªãªãŒã¹ã®ææ Œãæ¢ãŸããŸãããžã§ãã®ã¿ã€ã ã¢ãŠãã¯ããã¹ãã®å®è¡æé以äžã«èšå®ããŠãã ããã
èšå®ãæ©èœããŠããããšã確èªããã«ã¯
次ã®4ã€ã®ç¢ºèªã§ãèšå®ãæ©èœããŠãããã©ããã倿ã§ããŸãã
ãã¡ã€ã¢ãŠã©ãŒã«ã®ãšã©ãŒããªãã å®è¡çµæã®ãšã©ãŒãã¥ãŒã«ãWAFã«ãã403ãæ¥ç¶ãªã»ããã衚瀺ãããŠã¯ãããŸããã衚瀺ãããå Žåã¯ãèš±å¯ãªã¹ãã«ã¢ãã¬ã¹ãäžè¶³ããŠããããå¥ã®ãªãŒãžã§ã³ã®ã¢ãã¬ã¹ãç»é²ããŠããŸãã
äœè² è·ã§ã¯ããŒã«ã«ãšã¯ã©ãŠãã®çµæãäžèŽããã ããŒã«ã«ãšã¯ã©ãŠãã®äž¡æ¹ã§ã20ä»®æ³ãŠãŒã¶ãŒã§å®è¡ããŸããããŒã«ã«ã®p90ãã¯ããã«é«ããCPUã飜åããŠããå ŽåããããŸã§ã®ããŒã«ã«ã®æ°å€ã¯ãAPIã§ã¯ãªããã·ã³ã®æ§èœã枬ã£ãŠããããšã«ãªããŸãã
éçç¹ãããã£ãŠããã ã¯ã©ãŠãå®è¡ã§ä»®æ³ãŠãŒã¶ãŒæ°ã段éçã«å¢ããããšã©ãŒçã1%ãè¶ ããæç¹ãèšé²ããŸãããã®å€ãçŸæç¹ã®ãã£ãã·ãã£ã§ãããã¬ãã¥ãŒã§æ ¹æ ãšããŠç€ºãæ°å€ã«ãªããŸãã
ã¹ãããã·ã§ããã§ã¯ãªããã¬ã³ããèŠãã ã¯ãŒã¯ã¹ããŒã¹ã®å®è¡å±¥æŽã§ããªãªãŒã¹éã®p90ãæ¯èŒããŸããäžåºŠã倱æããããšã®ãªãé¢éã¯ãåºæºãç·©ãããå¯èœæ§ããããŸãã
éçIPã解決çã«ãªããªãã®ã¯ã©ã®ãããªå Žåã
ãã©ã€ããŒãå°çšã®ãã¹ãã APIã«ãããªãã¯ã¢ãã¬ã¹ããªãå Žåãèš±å¯ãªã¹ããžã®ç»é²ã§ã¯è§£æ±ºããŸããã代ããã«ããããã¯ãŒã¯å ã§Postman CLIãããã©ã«ãã®ããŒã«ã«ã©ã³ããŒã§å®è¡ããŸãããã®å Žåããã®ãã·ã³ã®ãªãœãŒã¹ãäžéã«ãªããŸãã
èš±å¯ãªã¹ãã¯èªèšŒã§ã¯ãªãã IPã®èš±å¯ãªã¹ãã¯ããšã³ããã€ã³ãã«å°éã§ããç¯å²ãçµã蟌ãã ãã§ããAPIã®èªèšŒã¯ãã®ãŸãŸç¶æããèªèšŒæ å ±ã¯CollectionãéããŠæž¡ããŸããã¯ã©ãŠãå®è¡ã§ã¯ãShared Vaultã®ã·ãŒã¯ã¬ããã䜿ããŸãã
ãªãŒãžã§ã³ã¯ã¢ã«ãŠã³ãã§æ±ºãŸãã ã¯ã©ãŠãå®è¡ã¯ãã¢ã«ãŠã³ãã®ãªãŒãžã§ã³ïŒããã©ã«ãã¯ç±³åœãEU Data Residencyãã©ã³ã§ã¯EUïŒãããã©ãã£ãã¯ãéä¿¡ããŸãã
ããå°èŠæš¡ãªãã¹ãã ã¯ã©ãŠãå®è¡ã«ã¯ãæäœ10ä»®æ³ãŠãŒã¶ãŒãå¿ èŠã§ããããæªæºãªããããŒã«ã«å®è¡ã®ã»ããç°¡åã§ãã
ãããã質å
éçIPã䜿ã£ãã¯ã©ãŠãã®ããã©ãŒãã³ã¹ãã¹ãã¯ãã©ã®Postmanãã©ã³ã§å©çšã§ããŸããïŒ
Postmanã®ææãã©ã³ã§å©çšã§ããŸãã以åã¯Enterpriseãã©ã³ã«éãããŠããŸãããã¯ã©ãŠãã®ããã©ãŒãã³ã¹ãã¹ãã®å®è¡ã§ã¯ãéçIPã䜿ããã©ããã«ãããããVUæéãæ¶è²»ãããŸããææ°ã®æéã¯ãPostmanã®æéããŒãžã§ç¢ºèªã§ããŸãã
CI/CDã§ãéçIPããPostmanã®ã¯ã©ãŠãããã©ãŒãã³ã¹ãã¹ããå®è¡ããã«ã¯ïŒ
éçIPã©ã³ããŒãæå®ããŠãPostman CLIã䜿ããŸããpostman performance run <collection-id> --runner postman-cloud-static-ipãå®è¡ããless_than(p90, 500)ã®ãããªãããå€ãæå®ããŠ--pass-ifã远å ããŸããã³ãã³ãã¯ã¯ã©ãŠãå®è¡ã®å®äºãåŸ ã¡ããããå€ãæºãããªãå Žåã¯ãŒã以å€ã®çµäºã³ãŒãã§çµäºãããããCI/CDãžã§ãã倱æããŸãã
ãããªãã¯ã¢ãã¬ã¹ã®ãªãAPIã§ããéçIPã¯äœ¿ããŸããïŒ
ããããPostmanã®ã¯ã©ãŠãããã©ãŒãã³ã¹ãã¹ãã®éçIPã¯ããããªãã¯ã«ã¢ãã¬ã¹æå®ã§ããéä¿¡å IPã§ãã©ãã£ãã¯ããã£ã«ã¿ãªã³ã°ããŠãããšã³ããã€ã³ãã察象ã§ããAPIã«ãã©ã€ããŒããããã¯ãŒã¯ããããå°éã§ããªãå Žåã¯ããã®ãããã¯ãŒã¯å ã§ãããã©ã«ãã®ããŒã«ã«ã©ã³ããŒã䜿ã£ãŠPostman CLIãå®è¡ããŸãããã®å Žåãè² è·ã¯å®è¡ãããã·ã³ããçæããããã®ãã·ã³ã®ãªãœãŒã¹ãäžéã«ãªããŸãã
ããŒã«ã«ãšPostman Cloudã®ã©ã¡ãã§è² è·ãã¹ããè¡ãã¹ãã§ããïŒ
äž¡æ¹ã䜿ããŸããã¢ããªãŸãã¯CLIã§ã®ããŒã«ã«å®è¡ã¯ã10ã20ä»®æ³ãŠãŒã¶ãŒã§å£ãã倿°ã倱æããã¢ãµãŒã·ã§ã³ãèŠã€ãããæè»œãªã¹ã¢ãŒã¯ãã¹ãã§ããã¯ã©ãŠãå®è¡ã§ã¯ãæ°çŸã®ä»®æ³ãŠãŒã¶ãŒãPostmanã®ãããŒãžããªã¯ãŒã«ãŒã«åæ£ãããããçµæã1å°ã®ãã·ã³ã®CPUããããã¯ãŒã¯ã«å¶éãããŸããã
次ã®ã¹ããã
éçIPã䜿ã£ãã¯ã©ãŠãã®ããã©ãŒãã³ã¹ãã¹ãã¯ãPostmanã®ææãã©ã³ã§å©çšã§ããŸããæåã®å®è¡ãèšå®ããã«ã¯ãéçIPããã¯ã©ãŠãã®ããã©ãŒãã³ã¹ãã¹ããå®è¡ããããã®ã¬ã€ããåç §ããŠãã ããã