Salesforce ã§ã¯ãApexãªã©ã§å©çšã§ããæå®ãã°ã€ã³æ å ±ãã¯ãããå€éšãªããžã§ã¯ã(Salesforce Connect)ãFiles Connectãªã©ãªã©ãã·ã³ã°ã«ãµã€ã³ãªã³ãå€éšWebã·ã¹ãã ãžãšæ¥ç¶ããããã®èªèšŒãããã€ããšããæ©èœãæäŸããŠããŸããèªèšŒã«æºããéšåãéçŽããããšã§ã管çã®äžå åãšåçŽåã«ã€ãªããã䟿å©ã§ãã
ãªãã§ãããOAuth ã§ã®æ¥ç¶ãããå Žåã«å°ãã ããããããã®ã§ããã®èšå®ã«ã€ããŠèª¬æããŸããä»åã¯äŸãšããŠãSalesforceã¯ãã¹çµç¹æ¥ç¶ã®ã±ãŒã¹ã§ããç¡åã§æäŸããããSalesforceã®éçºç°å¢ãäºã€ããã°å®çŸã§ããŸãããšèšãããšã§ããã¿ãªãããã©ããã䜿ããã ããã
æé ãšããŠã¯ãããªããŸãã
- (æ¥ç¶ãããåŽ)æ¥ç¶ã¢ããªã±ãŒã·ã§ã³ã®äœæ
- (æ¥ç¶ããåŽ)èªèšŒãããã€ãã®äœæ
- (æ¥ç¶ãããåŽ)æ¥ç¶ã¢ããªã±ãŒã·ã§ã³ã®ç·šé
- (æ¥ç¶ããåŽ)æå®ãã°ã€ã³æ å ±/å€éšããŒã¿ãœãŒã¹ã®äœæ
ãšããæé ã«ãªããŸããè¡ã£ããæ¥ããã«ãªãã®ã¯çç±ããããããªãã§ãΩ ΩΩ< ãªããªãã ã£ãŠãŒ!!
1. (æ¥ç¶ãããåŽ)æ¥ç¶ã¢ããªã±ãŒã·ã§ã³ã®äœæ
ãŸãã¯æ¥ç¶ãããåŽã§æ¥ç¶ã¢ããªã±ãŒã·ã§ã³ãäœæããŸããããŒã¿ã¢ã¯ã»ã¹ãæäŸããåŽã®Salesforceããã¢ã¯ã»ã¹å¯èœãªãŠãŒã¶ã®å¶åŸ¡ããå©çšã§ããAPIãªã©ã®å¶åŸ¡ãè¡ãããã®èšå®ã§ãããŸãããããªããšè©±ã«ãªããŸããã
Salesforceã®èšå®ããŒãžããæäœããŸããã¯ã€ãã¯æ€çŽ¢ãããã¢ããªã±ãŒã·ã§ã³ããšãã§æ€çŽ¢ããããã¢ããªã±ãŒã·ã§ã³ã«ããŽãªãããã¢ããªã±ãŒã·ã§ã³ãããŒãžã£ãã¯ãªãã¯ããŸãã
ããããã«å³äžã®æ°èŠæ¥ç¶ã¢ããªã±ãŒã·ã§ã³ãã¯ãªãã¯ããŸããããããäžã€ããæ°èŠLightningã¢ããªã±ãŒã·ã§ã³ã§ã¯ãããŸãããããããããæ°èŠæ¥ç¶ã¢ããªã±ãŒã·ã§ã³ã§ããå³åŽã§ãã
æ°èŠæ¥ç¶ã¢ããªã±ãŒã·ã§ã³äœææã®å ¥åé ç®
OAuthã§æ¥ç¶ãããå Žåã«ã¯ãåºæ¬æ
å ±ã®å
¥åå¿
é é
ç®ä»¥å€ã«OAuth èšå®ã®æå¹åãå¿
èŠã§ããéã«èšãã°ãããããèšå®ããã°è¯ãã§ãã
| èšå®é ç® | èšå®ããå 容 |
|---|---|
| æ¥ç¶ã¢ããªã±ãŒã·ã§ã³å | 人æ§ãèå¥ããããã®ååã§ããåããã°äœã§ãè¯ãã§ããèå¥ã§ããã° |
| API åç §å | APIã§åç §ãããšãã«äœ¿ãååã§ããå¿ ãè±èªã§ããã¢ã³ã¹ã³ã䜿ããŸããæ°åããããæ°ãããŸã |
| ååŒå 責任è ã¡ãŒã« | ãã®æ¥ç¶ã¢ããªã管çãã人ã®ã¡ã¢ãå ¥ããŠãããŸãããªãããããšéç¥ãããŸã |
| ã³ãŒã«ãã㯠URL | ä»ã¯äœã§ãããã§ããhttps:// ã§å§ãŸãäœãé©åœãªURLããããŸã |
| éžæãã OAuth ç¯å² | å©çšãããOAuthã®ã¹ã³ãŒããå®çŸ©ããŸããèããã®ãé¢åãªãã¹ãã®æã¯fullãšrefresh_tokenãããã°è¯ãã§ããrefresh_tokenã¯fullã«å«ãŸããªãã®ã§ãã£ãã«èšå®ãå¿
èŠã§ã |
ããšã¯ã²ãšãŸãããã©ã«ãã§è¯ãã§ãããªããSalesforce Connectãå©çšããå Žåã®æäœéã®OAuthã¹ã³ãŒãã¯ãããã«ããããšããæ¬¡ã®åã€ã§ãã
- Web çµç±ã®ããŒã¿ãžã®ã¢ã¯ã»ã¹ãæäŸ (web)
- ããŒã¿ãžã®ã¢ã¯ã»ã¹ãšç®¡ç (api)
- åºæ¬æ å ±ãžã®ã¢ã¯ã»ã¹ (id, profile, email, address, phone)
- ãŠãŒã¶ã«ä»£ãã£ãŠãã€ã§ãèŠæ±ãå®è¡ (refresh_token, offline_access)
refresh_token ã¯éèŠã§ãããããŸã§å ¥åããããä¿åãããŸãããµãŒãäžã§èšå®ãæå¹ã«ãªããŸã§2ã10ååŸ ãŠãšåºãŠããŸããã倧æµãã䜿ããŸããããŸã«ãã£ã¡ãæéããããŸãã
èšå®ã«å¿ èŠãªé ç®ã®ã¡ã¢(ã³ããããçš)
ããšã§ãèªèšŒãããã€ããäœæãããšãã«å¿
èŠãªæ¬¡ã®é
ç®ãã¡ã¢ããŠãããŸããã©ã£ãã«äžæçã«ããŒã¹ãããŠãããšããŸãããã䟿å©ãªããšã«ãããããã³ããŒãã¿ã³ãã€ããŠãŸããçŽ æŽãããã
- ã³ã³ã·ã¥ãŒãéµ
- ã³ã³ã·ã¥ãŒãã®ç§å¯ (ã¯ãªãã¯ããªããšåºãŠããŸãã)
ã¢ã¯ã»ã¹ãããŠãŒã¶ã®è¿œå
ãã®ãæ¥ç¶ã¢ããªã±ãŒã·ã§ã³ããéããŠã¢ã¯ã»ã¹å¯èœãªãŠãŒã¶ãå®çŸ©ããŸããManageãã¿ã³ãã¯ãªãã¯ããŠãæ¥ç¶ã¢ããªã±ãŒã·ã§ã³ã®è©³çްãã衚瀺ããããïœããªã·ãŒãç·šé`ãã¿ã³ãæŒããŸãã
ãã®äžã®ãOAuth ããªã·ãŒããªãã® "èš±å¯ãããŠãããŠãŒã¶" ã "管çè ãæ¿èªãããŠãŒã¶ã¯äºåæ¿èªæžã¿" ãžå€æŽããŠä¿åããŸãã
ãããšãäžã®æ¹ã«ããããã¡ã€ã«ããšãæš©éã»ããããšããé¢é£ãªã¹ãã远å ãããŠããŸããããã§èç®ãæ¯ããäžå¿äžä¹±ã«ããããã¡ã€ã«ã管çããããã¿ã³ãã¯ãªãã¯ããŸããæ¬¡ã®ãããªãã¢ããªã±ãŒã·ã§ã³ãããã¡ã€ã«ã®å²ãåœãŠãç»é¢ã衚瀺ãããŸããããã§ããã®æ¥ç¶ã¢ããªã±ãŒã·ã§ã³ãéããŠã¢ã¯ã»ã¹ãããããŠãŒã¶ã®æã€ãããã¡ã€ã«ãéžæããŸããäžè¬çã«å°çšã®APIãŠãŒã¶ãæºåããããã·ã¹ãã 管çè ãå©çšããã§ãããããã®ãŠãŒã¶ã«äžããŠãããããã¡ã€ã«ãéžæããŸãããã®ãããã¡ã€ã«ãæã€ãŠãŒã¶ããã¢ã¯ã»ã¹ã§ããŸããã
2. (æ¥ç¶ããåŽ)èªèšŒãããã€ãã®äœæ
ãããŠãä»åºŠã¯æ¥ç¶ãããåŽãå ã»ã©æ¥ç¶ã¢ããªã±ãŒã·ã§ã³ãäœæããSalesforceã®çµç¹ãžã¢ã¯ã»ã¹ããåŽã®çµç¹ã§èšå®ããŸããSalesforceã®èšå®ç»é¢ãããèªèšŒãããã€ãããžã¢ã¯ã»ã¹ããŸããèšå®ã®äžãçžåœäžãæã£ããããäžã«ãããIDãã«ããŽãªå ã«ãèªèšŒãããã€ããããããŸããã¯ã€ãã¯æ€çŽ¢ããæ¹ãæ©ãã§ãã
ãã¡ããã¯ãªãã¯ãããªãã°ãããããŸãæ°èŠãã§ãããããã€ãã¿ã€ãã®èšå®ç»é¢ã®ã¿ããããŸãã®ã§ããããããSalesforceããéžæããŸããã芧ããã ããã°åãããšããã2020幎12æçŸåšã次ã®10ã®ãããã€ãã«å¯Ÿå¿ããŠããŸãããã以å€ã®ãããã€ããå©çšãããå Žåã¯ãã«ã¹ã¿ã èªèšŒãããã€ããèªäœããããšãå¯èœã§ããæäœ[Salesforce] ã«ã¹ã¿ã èªèšŒãããã€ãã®äœãæ¹ ~Client Credentials ç·š~ãã芧ããã ãããšå¹žãã§ããããã¿ãŠæ°ãã€ããŸããããAzureã©ããã£ãã
| èšå®é ç® | èšå®å 容 |
|---|---|
| åå | 人æ§ãèªèããããã«å¿ èŠãªã ãã®ååã§ããäœã§ããã |
| URL æ¥å°ŸèŸ | æ¿èªã«å¿ èŠãªããŸããŸãªURLã®æåŸã«ä»äžããããã®ã§ããããããAPIèå¥åã¿ãããªãã®ã§ãããŠããŒã¯ãªè±èªãªãäœã§ãã©ãã |
| ã³ã³ã·ã¥ãŒãéµ | å
ã»ã©ã³ãããããšãã£ãã³ã³ã·ã¥ãŒãéµã§ã |
| ã³ã³ã·ã¥ãŒãã®ç§å¯ | åããã³ã³ã·ã¥ãŒãã®ç§å¯ã§ã |
| æ¿èªãšã³ããã€ã³ã URL | ç§ã®ãã¡ã€ã³ãèšå®ãããŠããã¯ããªã®ã§ããããæå®ããæ¹ã飿ºã¯å®¹æã§ããããã©ã«ãã®ãŸãŸã§ããããŸããããã¹ãåã®åŸãã¯å¿
ã /services/oauth2/authorize ã§ã |
| ããŒã¯ã³ãšã³ããã€ã³ã URL | äžèšéãã§ããããã¡ãã¯ãã¹ãå以åŸã¯ /services/oauth2/tokenã«å¿
ããªããŸã |
| ããã©ã«ãã®ç¯å² | æéèŠãã€ã³ãã§ããããã§å¿
ãrefresh_tokenãå
¥ããã°ãªããŸããããã以å€ã«å¿
èŠãªOAuthã¹ã³ãŒããå
¥ããŸã |
ãããŸã§èšå®ã§ããããä¿åãããŸããããã®åŸã«ãéèŠãªãã€ã³ãããããŸããä¿åãããåŸã®ç»é¢ã«ãã ã³ãŒã«ãã㯠URL ã® URLãã³ããããŠã¡ã¢ããŠãããŸããäžã®æ¹ã® Salesforce èšå®å
ã«ãããŸãããã
ããã©ã«ãã®ç¯å² ã«ã€ããŠ
Salesforce ã®èªèšŒãããã€ãã§ã¯ãããã©ã«ãã®OAuthã¹ã³ãŒãã«refresh_tokenã®å«ãŸããªãfullãããŒãã³ãŒããããŠããããã§ããæ¥ç¶ãããåŽã§ãããrefresh_tokenãšfullãæå®ããŠãããŠããrefresh tokenãååŸããŸããããªã®ã§å¿
ããOAuth ã§refresh tokenãå¿
èŠãªå Žåã«ã¯ãããã§refresh_tokenãæå®ããªããã°ãªããŸãããããã¯ãããªãæ¹ã®çŸ©åã§ãã䜿åœã§ãã
ãªãrefresh_tokenãæå®ãããããã©ã«ãã®ç©ºæ¬ã«ãããŸãŸããå€éšããŒã¿ãœãŒã¹ãããæå®ãã°ã€ã³æ
å ±ããèšå®ãããšã©ããªãããèªèšŒèªäœã¯éãã®ã§ããããã®ãããªã¡ãã»ãŒãžãåºãŠrefresh tokenãååŸã§ããªãã£ãããšãåãããŸããæ³šæå§åçšåºŠã®ã¡ãã»ãŒãžã«èŠããŸãããã¯ã£ããèšã£ãŠå©çšã§ããŸãããrefresh_tokenãå®çŸ©ããªããšããã®èªèšŒãããã€ãã¯å©çšã§ããªãã«çããã§ãã
æ€çŽ¢çš: èªèšŒãããã€ããæŽæ°ããŒã¯ã³ãæäŸããŸããã§ãããã¢ã¯ã»ã¹ããŒã¯ã³ã®æå¹æéãåãããšãçµç¹ãããã®å€éšããŒã¿ãœãŒã¹ã«ã¢ã¯ã»ã¹ã§ããªããªããŸãã
3. (æ¥ç¶ãããåŽ)æ¥ç¶ã¢ããªã±ãŒã·ã§ã³ã®ç·šé
ããŠããŸãã¢ã¯ã»ã¹ãããåŽã«æ»ããŸããå
ã»ã©é©åœã«å®çŸ©ããã³ãŒã«ããã¯URLãèšå®ããŸããå
ã»ã©äœæãããæ¥ç¶ã¢ããªã±ãŒã·ã§ã³ããéãçŽããŠãç·šéãããŸãããããŠãå
ã»ã©éã«å
¥åãããã³ãŒã«ãã㯠URLãéšåããèªèšŒãããã€ãã§å®çŸ©ããããã³ãŒã«ãã㯠URLãã§äžæžãããŠä¿åããŠãããŸããããã§ãåãå
¥ãå®äºã§ãã
4. (æ¥ç¶ããåŽ)æå®ãã°ã€ã³æ å ±/å€éšããŒã¿ãœãŒã¹ã®äœæ
ããšã¯å©çšããã¢ããªã±ãŒã·ã§ã³ã«åŸã£ãŠãèªèšŒãããã€ããå©çšããããã«å®çŸ©ããŸããäž»ã«ãæå®ãã°ã€ã³æ å ±ããšãå€éšããŒã¿ãœãŒã¹(Salesforce Connectã䜿çšããå Žå)ãã§ããããããããèšå®æ¹æ³ã¯ã ãããåãã§ããããããèšå®ãä¿åãããšãSalesforce ã®èªèšŒç»é¢ã衚瀺ãããŸãã®ã§ã該åœãããŠãŒã¶ã§ãã°ã€ã³ããŠãããã°èšå®å®äºã§ãããã£ãã(à¹â¢Ìã â¢Ì)Ùâ§
ãªãããã°ã€ã³å
ã®URLãæå®ããªãã£ãããèšå®ããªãã£ããããŠãããããªå Žåã§ãã〠https://login.salesforce.com ããã®ãã°ã€ã³ãçŠæ¢ãããŠãããšãã°ã€ã³ã§ããŸãããURLãæå®ããããèªèšŒæã«ãã«ã¹ã¿ã ãã¡ã€ã³ã䜿çšããšããŠããã¡ã€ã³ãæå®ããŠãã°ã€ã³ããŸãããã
æå®ãã°ã€ã³æ å ±ã®å Žå
| èšå®å | èšå®å 容 |
|---|---|
| 衚瀺ã©ãã« | ãªãã§ããã(ry |
| åå | APIãšã¯æžããŠãŸãããããããAPIã§ã¢ã¯ã»ã¹ããéã®èå¥åãªã®ã§ãè±èªã§æå®ããŸã |
| URL | æ¥ç¶ããå
ã®Salesforceã®ãã°ã€ã³URLãæå®ããŸããlogin.salesforce.comã§ããããæ°ããããã©ãç§ã®ãã¡ã€ã³ã§èšå®ããã«ã¹ã¿ã ãã¡ã€ã³ã®æ¹ãæãããããŸãã |
| ID çš®å¥ |
ãŠãŒã¶ãšãããšãã®ãããã€ããå©çšãããŠãŒã¶ããšã«ãã°ã€ã³ãããŠãŒã¶ãæå®ã§ããŸããæå®ãŠãŒã¶ã«ãããšãããã§æå®ãããŠãŒã¶ã§ãã¹ãŠã®ãŠãŒã¶ã¯å€éšã·ã¹ãã ãžã¢ã¯ã»ã¹ããããã«ãªããŸã |
| èªèšŒãããã³ã« | ä»åã®ã±ãŒã¹ã§ã¯ããã¡ããOAuth 2.0ãæå®ããŸã |
| èªèšŒãããã€ã | ããã»ã©äœæããèªèšŒãããã€ãã«ããŸããå€ãªååã«ãããšããããªããšã«ãªãã®ã§ãªã¹ã¹ã¡ããŸãã |
| ç¯å² | èªèšŒãããã€ãã§æå®ããç¯å²ãããçããŠå©çšãããå Žåã«ã¯ããã§å®çŸ©ããŸã |
æå®ãã°ã€ã³æ å ±ãèšå®ãããšãApexã§ã®ã³ãŒã«ã¢ãŠããå€éšãµãŒãã¹ã§å©çšã§ããŸãã
å€éšããŒã¿ãœãŒã¹ã®å Žå
| èšå®å | èšå®å 容 |
|---|---|
| å€éšããŒã¿ãœãŒã¹ | ãªãã§ããã(ry |
| åå | APIãšã¯æžããŠãŸãããããããAPIã§ã¢ã¯ã»ã¹ããéã®èå¥åãªã®ã§ãè±èªã§æå®ããŸã |
| çš®å¥ | Salesforce Connect ãå©çšããçžæå
ã®çš®é¡ãæå®ããŸããä»åã®ã±ãŒã¹ã ãšSalesforce Connect: ã¯ãã¹çµç¹äžæã§ã |
| æ¥ç¶å | 察象ãšãªãSalesforceã®ç°å¢ã«åãããŠãProduction ã Sandbox ãæå®ããŸããã«ã¹ã¿ã ãã¡ã€ã³ãå©çšããŠããå Žåã«ã¯ããã®ããã«Custom URLã«ããŠURLãå®çŸ©ãããåã§ã |
| URL |
Custom URLãšããå Žåã«ã¯ãæ¥ç¶å
ã®URLãæå®ããŸã |
| APIããŒãžã§ã³ | ãªãã¹ãææ°ãããããŠæã®APIãå©çšãããå Žåãªã©ã«ã¯ãããã§å¶åŸ¡ããŸã |
| ID çš®å¥ |
ãŠãŒã¶ãšãããšãã®ãããã€ããå©çšãããŠãŒã¶ããšã«ãã°ã€ã³ãããŠãŒã¶ãæå®ã§ããŸããæå®ãŠãŒã¶ã«ãããšãããã§æå®ãããŠãŒã¶ã§ãã¹ãŠã®ãŠãŒã¶ã¯å€éšã·ã¹ãã ãžã¢ã¯ã»ã¹ããããã«ãªããŸã |
| èªèšŒãããã³ã« | ä»åã®ã±ãŒã¹ã§ã¯ããã¡ããOAuth 2.0ãæå®ããŸã |
| èªèšŒãããã€ã | ããã»ã©äœæããèªèšŒãããã€ãã«ããŸããå€ãªååã«ãããšããããªããšã«ãªãã®ã§ãªã¹ã¹ã¡ããŸãã |
| ç¯å² | èªèšŒãããã€ãã§æå®ããç¯å²ãããçããŠå©çšãããå Žåã«ã¯ããã§å®çŸ©ããŸã |
å€éšããŒã¿ãœãŒã¹ãèšå®ãããšãæ¥ç¶ãããŠããåŽã®Salesforceã®ãªããžã§ã¯ããžã¢ã¯ã»ã¹ãå¯èœã«ãªããŸããä¿åããåŸããæ€èšŒããŠåæããã¿ã³ãã¯ãªãã¯ãããšãå€éšãªããžã§ã¯ãããšããŠå©çšããããªããžã§ã¯ãã®éžæç»é¢ã«ãªããŸããæ¬¡ã®ããã«ãAccount(ååŒå )ããªããžã§ã¯ããéžæããŠãåæããããšå€éšãªããžã§ã¯ããšããŠãçžæå ã®ååŒå ãªããžã§ã¯ããã«ã¹ã¿ã ãªããžã§ã¯ãã®ããã«å©çšã§ããããã«ãªããŸãã
ãžã.















