AWS API-Gateway är stor som en front för Lambda-funktioner och andra AWS tjänster. Men, standard slutpunkten är en underdomän av amazonaws.com vilket inte är användarvänlig. Vi kommer att visa hur du fixar och ställa in en egen domän.
Begära ett Certifikat från ACM och Länk API Gateway
Du behöver ägande av domännamn du vill använda för API. Du vill förmodligen för att sätta detta på en underdomän som api.example.com. För att göra detta, behöver du göra två saker: begäran om ett SSL-certifikat från AWS Certifikat (ACM) för att säkra förfrågningar till API, och uppdatera din DNS-konfiguration för att peka på API-Gateway.
Logga in och gå över till ACM-Konsolen. Här väljer du “Request A Certificate” och ange “Allmänheten” som typ.
Nästa upp, in i det domännamn du vill använda för detta certifikat. Du kan lägga till flera domäner här, men en är nog tillräckligt, som API steg delar upp sub-Url: er ändå.
Du har två alternativ för validering. Den första kommer att kräva att du uppdaterar din DNS-konfigurationen med en CNAME-post. Den andra kommer att skicka ett verifieringsmail till den e-post du har på kontakt för domänen. Detta kommer inte att fungera om din e-post inte är synlig från vem.är som kommer att hända om du har WhoisGuard skydd.
DNS-konfiguration är ganska lätt, så vi ska gå med det. Nästa skärm kommer att visa dig namn och värde för den post som du behöver för att skriva. Om du använder Route 53, Amazons egna domänregistrator och DNS-tjänst, denna process är automatisk och du kan helt enkelt trycka på “Skapa Post I Väg 53” att göra detta för dig.
Det kan ta några minuter för ändringarna att distribueras om du använder en tredje parts ombud. När validerade, ditt certifikat bör ändra status till “Utfärdats”, och kommer vara redo att länka till API-Gateway.
Växla över till API-Gateway-konsolen och klicka på “Eget Domännamn” i sidomenyn. Skapa ett nytt, skriv in ditt domännamn och välj det certifikat som du just har skapat. Du måste också se till att du har rätt API-typ som är vald.
Klicka på skapa en ny domän ska visa upp i listan. Klicka på “Redigera” för att lägga till en sökväg kartläggning. Detta kommer att länka en särskild underdomän (till exempel, api.example.com/v1/) till API och steg som du väljer.
Det skulle nog vara en bra idé att skapa olika vägar för olika API stadier, som en utvecklingsväg för $standard scenen, och en produktion väg för användaren som vetter mot scenen.
När de har skapats, kopiera “Target Domain Name” value. Detta är vad du behöver för att uppdatera DNS-konfiguration (inte API endpoint själv).
Länka Din DNS-API-Gateway
Du kommer att märka i detta skede att om du besöker adressen i din webbläsare, kommer ingenting att hända. API-Porten är konfigurerad för att använda din domän säkert, men det är det inte tar emot någon trafik eftersom DNS-inte pekar vem som helst var som helst.
För tredje part DNS, du måste använda en CNAME-post. Detta kartor ett domännamn till en annan domän namn, men kräver ett extra DNS lookup. Klistra in i “Mål Domännamn” – värdet för den anpassade domän som du konfigurerar i API-Gateway.
api.example.com CNAME api-id.execute-api.region.amazonaws.com/stage
Om du använder Route 53, konfigurationen är enklare. Du kan uppnå samma effekt i en sökning med hjälp av Ett rekord för “Alias” – läge, en speciell posttyp som tillåter dig att karta spela in direkt till en AWS resurs namn. Välj helt enkelt API från listan, och klicka på skapa.
Förändringar kommer att ta lite för att propagera, men din API bör nu vara tillgängligt från ditt domännamn. Om det inte fungerar, kontrollera så att du se till att ansluta via HTTPS, så det kommer inte att acceptera icke-säker anslutning.