빠른 시작: Node.js 앱과 함께 Azure Cache for Redis 사용

캐시에서 Microsoft Entra ID 인증 사용

기존 캐시의 경우 먼저 Microsoft Entra 인증이 사용하도록 설정되어 있는지 확인합니다. 그렇지 않은 경우 다음 단계를 완료하여 Microsoft Entra 인증을 사용하도록 설정합니다. 애플리케이션에서 인증에 Microsoft Entra ID를 사용하는 것이 좋습니다.

1. Azure Portal에서 Microsoft Entra 토큰 기반 인증을 사용하려는 Azure Cache for Redis 인스턴스를 선택합니다.

2. 서비스 메뉴의 설정 아래에서 인증을 선택합니다.

3. 인증 창에서 Microsoft Entra 인증 사용 확인란이 선택되어 있는지 확인합니다. 선택된 경우 다음 섹션으로 이동할 수 있습니다.

4. 그렇지 않은 경우 Microsoft Entra 인증 사용 확인란을 선택합니다. 그런 다음 유효한 사용자의 이름을 입력합니다. 저장을 선택합니다. 입력한 사용자 이름에 데이터 소유자 액세스 정책이 자동으로 할당됩니다.

   관리 ID 또는 서비스 주체를 입력하여 캐시에 연결할 수도 있습니다.

   

5. 대화 상자에 구성을 업데이트할지 묻는 메시지가 표시되고 업데이트를 완료하는 데 몇 분 정도 걸린다는 메시지가 표시됩니다. 예를 선택합니다.

   Important

   사용 작업이 완료되면 캐시의 노드가 다시 부팅되어 새 구성을 로드합니다. 표준 유지 관리 기간 동안 또는 사용량이 많은 업무 시간 외에 이 작업을 완료하는 것이 좋습니다. 이 프로세스는 최대 30분 정도 걸릴 수 있습니다.

Azure CLI와 함께 Microsoft Entra ID를 사용하는 방법에 대한 자세한 내용은 ID 참조 페이지를 참조하세요.

JavaScript용 Azure ID 클라이언트 라이브러리를 설치합니다.

JavaScript용 Azure ID 클라이언트 라이브러리는 필수 MSAL(Microsoft 인증 라이브러리)을 사용하여 토큰 인증 지원을 제공합니다. npm을 사용하여 라이브러리를 설치합니다.

npm install @azure/identity

Microsoft Entra ID를 사용하여 Node.js 앱 만들기

1. 호스트 이름과 서비스 주체 ID에 대한 환경 변수를 추가합니다.

   서비스 주체 ID는 Microsoft Entra ID 서비스 주체 또는 사용자의 개체 ID입니다. Azure Portal에서 이 값은 사용자 이름으로 나타납니다.

   set AZURE_CACHE_FOR_REDIS_HOST_NAME=contosoCache
   set REDIS_SERVICE_PRINCIPAL_ID=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   

2. redistest.js라는 스크립트 파일을 만듭니다.

3. 다음 예제 JavaScript를 파일에 추가합니다. 이 코드는 캐시 호스트 이름과 키 환경 변수를 사용하여 Azure Cache for Redis 인스턴스에 연결하는 방법을 보여 줍니다. 코드는 또한 캐시에 문자열 값을 저장하고 검색합니다. 또한 PING 및 CLIENT LIST 명령을 실행했습니다. node-redis 클라이언트가 포함된 Redis 사용에 관한 더 많은 예는 Node-Redis를 참조하세요.

   const { createClient } = require("redis");
   const { DefaultAzureCredential } = require("@azure/identity");
   
   async function main() {
     // Construct a Token Credential from Identity library, e.g. ClientSecretCredential / ClientCertificateCredential / ManagedIdentityCredential, etc.
     const credential = new DefaultAzureCredential();
     const redisScope = "https://redis.azure.com/.default";
   
     // Fetch a Microsoft Entra token to be used for authentication. This token will be used as the password.
     let accessToken = await credential.getToken(redisScope);
     console.log("access Token", accessToken);
   
     // Create redis client and connect to the Azure Cache for Redis over the TLS port using the access token as password.
     const cacheConnection = createClient({
       username: process.env.REDIS_SERVICE_PRINCIPAL_ID,
       password: accessToken.token,
       url: `redis://${process.env.AZURE_CACHE_FOR_REDIS_HOST_NAME}:6380`,
       pingInterval: 100000,
       socket: { 
         tls: true,
         keepAlive: 0 
       },
     });
   
     cacheConnection.on("error", (err) => console.log("Redis Client Error", err));
     await cacheConnection.connect();
   
     // PING command
     console.log("\nCache command: PING");
     console.log("Cache response : " + await cacheConnection.ping());
   
     // SET
     console.log("\nCache command: SET Message");
     console.log("Cache response : " + await cacheConnection.set("Message",
         "Hello! The cache is working from Node.js!"));
   
     // GET
     console.log("\nCache command: GET Message");
     console.log("Cache response : " + await cacheConnection.get("Message"));
   
     // Client list, useful to see if connection list is growing...
     console.log("\nCache command: CLIENT LIST");
     console.log("Cache response : " + await cacheConnection.sendCommand(["CLIENT", "LIST"]));
   
     cacheConnection.disconnect();
   
     return "Done"
   }
   
   main().then((result) => console.log(result)).catch(ex => console.log(ex));
   

4. Node.js를 사용하여 스크립트를 실행합니다.

   node redistest.js
   

5. 코드의 출력이 다음 예제와 같은지 확인합니다.

   Cache command: PING
   Cache response : PONG
   
   Cache command: GET Message
   Cache response : Hello! The cache is working from Node.js!
   
   Cache command: SET Message
   Cache response : OK
   
   Cache command: GET Message
   Cache response : Hello! The cache is working from Node.js!
   
   Cache command: CLIENT LIST
   Cache response : id=10017364 addr=76.22.73.183:59380 fd=221 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 argv-mem=10 obl=0 oll=0 omem=0 tot-mem=61466 ow=0 owmem=0 events=r cmd=client user=default numops=6
   
   Done
   

재인증이 있는 샘플 JavaScript 앱 만들기

Microsoft Entra ID 액세스 토큰의 수명은 약 75분으로 제한됩니다. 캐시에 대한 연결을 유지하려면 토큰을 새로 고쳐야 합니다.

이 예제에서는 JavaScript를 사용하여 토큰을 새로 고치는 방법을 보여 줍니다.

1. redistestreauth.js라는 스크립트 파일을 만듭니다.

2. 다음 예제 JavaScript를 파일에 추가합니다.

    const { createClient } = require("redis");
    const { DefaultAzureCredential } = require("@azure/identity");
   
    async function returnPassword(credential) {
        const redisScope = "https://redis.azure.com/.default";
   
        // Fetch a Microsoft Entra token to be used for authentication. This token will be used as the password.
        return credential.getToken(redisScope);
    }
   
    async function main() {
      // Construct a Token Credential from Identity library, e.g. ClientSecretCredential / ClientCertificateCredential / ManagedIdentityCredential, etc.
      const credential = new DefaultAzureCredential();
      let accessToken = await returnPassword(credential);
   
      // Create redis client and connect to the Azure Cache for Redis over the TLS port using the access token as password.
      let cacheConnection = createClient({
        username: process.env.REDIS_SERVICE_PRINCIPAL_ID,
        password: accessToken.token,
        url: `redis://${process.env.AZURE_CACHE_FOR_REDIS_HOST_NAME}:6380`,
        pingInterval: 100000,
        socket: { 
          tls: true,
          keepAlive: 0 
        },
      });
   
      cacheConnection.on("error", (err) => console.log("Redis Client Error", err));
      await cacheConnection.connect();
   
      for (let i = 0; i < 3; i++) {
        try {
            // PING command
            console.log("\nCache command: PING");
            console.log("Cache response : " + await cacheConnection.ping());
   
            // SET
            console.log("\nCache command: SET Message");
            console.log("Cache response : " + await cacheConnection.set("Message",
                "Hello! The cache is working from Node.js!"));
   
            // GET
            console.log("\nCache command: GET Message");
            console.log("Cache response : " + await cacheConnection.get("Message"));
   
            // Client list, useful to see if connection list is growing...
            console.log("\nCache command: CLIENT LIST");
            console.log("Cache response : " + await cacheConnection.sendCommand(["CLIENT", "LIST"]));
          break;
        } catch (e) {
          console.log("error during redis get", e.toString());
          if ((accessToken.expiresOnTimestamp <= Date.now())|| (redis.status === "end" || "close") ) {
            await redis.disconnect();
            accessToken = await returnPassword(credential);
            cacheConnection = createClient({
              username: process.env.REDIS_SERVICE_PRINCIPAL_ID,
              password: accessToken.token,
              url: `redis://${process.env.AZURE_CACHE_FOR_REDIS_HOST_NAME}:6380`,
              pingInterval: 100000,
              socket: {
                tls: true,
                keepAlive: 0
              },
            });
          }
        }
      }
    }
   
    main().then((result) => console.log(result)).catch(ex => console.log(ex));
   

3. Node.js를 사용하여 스크립트를 실행합니다.

   node redistestreauth.js
   

4. 다음 예제와 유사한 출력을 확인합니다.

    Cache command: PING
    Cache response : PONG
   
    Cache command: GET Message
    Cache response : Hello! The cache is working from Node.js!
   
    Cache command: SET Message
    Cache response : OK
   
    Cache command: GET Message
    Cache response : Hello! The cache is working from Node.js!
   
    Cache command: CLIENT LIST
    Cache response : id=10017364 addr=76.22.73.183:59380 fd=221 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 argv-mem=10 obl=0 oll=0 omem=0 tot-mem=61466 ow=0 owmem=0 events=r cmd=client user=default numops=6
   
   

호스트 이름, 포트 및 액세스 키 가져오기

Azure Cache for Redis 서버에 연결하려면 캐시 클라이언트에 캐시의 호스트 이름, 포트 및 액세스 키가 필요합니다. 일부 클라이언트는 약간 다른 이름을 사용하여 이러한 항목을 참조할 수 있습니다. Azure Portal에서 호스트 이름, 포트 및 키를 가져올 수 있습니다.

• 캐시에 대한 액세스 키를 가져오려면 다음을 수행합니다.

  1. Azure Portal에서 캐시로 이동합니다.
  2. 서비스 메뉴의 설정 아래에서 인증을 선택합니다.
  3. 인증 창에서 액세스 키 탭을 선택합니다.
  4. 액세스 키 값을 복사하려면 키 필드에서 복사 아이콘을 선택합니다.

  

• 캐시에 대한 호스트 이름 및 포트를 가져오려면 다음을 수행합니다.

  1. Azure Portal에서 캐시로 이동합니다.
  2. 서비스 메뉴에서 개요를 선택합니다.
  3. Essentials 아래에서 호스트 이름의 경우 복사 아이콘을 선택하여 호스트 이름 값을 복사합니다. 호스트 이름 값에는 <DNS name>.redis.cache.windows.net 형식이 있습니다.
  4. 포트의 경우 복사 아이콘을 선택하여 포트 값을 복사합니다.

  

호스트 이름과 기본 액세스 키에 대한 환경 변수를 추가합니다. 코드에 직접 중요한 정보를 포함하는 대신 사용자 코드에서 이러한 변수를 사용합니다.

set AZURE_CACHE_FOR_REDIS_HOST_NAME=contosoCache
set AZURE_CACHE_FOR_REDIS_ACCESS_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

캐시에 연결

새 Node.js 앱 만들기

1. redistest.js라는 새 스크립트 파일을 만듭니다.

2. 다음 예제 JavaScript를 파일에 추가합니다.

   const redis = require("redis");
   
   // Environment variables for cache
   const cacheHostName = process.env.AZURE_CACHE_FOR_REDIS_HOST_NAME;
   const cachePassword = process.env.AZURE_CACHE_FOR_REDIS_ACCESS_KEY;
   
   if(!cacheHostName) throw Error("AZURE_CACHE_FOR_REDIS_HOST_NAME is empty")
   if(!cachePassword) throw Error("AZURE_CACHE_FOR_REDIS_ACCESS_KEY is empty")
   
   async function testCache() {
   
       // Connection configuration
       const cacheConnection = redis.createClient({
           // redis for TLS
           url: `redis://${cacheHostName}:6380`,
           password: cachePassword
       });
   
       // Connect to Redis
       await cacheConnection.connect();
   
       // PING command
       console.log("\nCache command: PING");
       console.log("Cache response : " + await cacheConnection.ping());
   
       // GET
       console.log("\nCache command: GET Message");
       console.log("Cache response : " + await cacheConnection.get("Message"));
   
       // SET
       console.log("\nCache command: SET Message");
       console.log("Cache response : " + await cacheConnection.set("Message",
           "Hello! The cache is working from Node.js!"));
   
       // GET again
       console.log("\nCache command: GET Message");
       console.log("Cache response : " + await cacheConnection.get("Message"));
   
       // Client list, useful to see if connection list is growing...
       console.log("\nCache command: CLIENT LIST");
       console.log("Cache response : " + await cacheConnection.sendCommand(["CLIENT", "LIST"]));
   
       // Disconnect
       cacheConnection.disconnect()
   
       return "Done"
   }
   
   testCache().then((result) => console.log(result)).catch(ex => console.log(ex));
   

   이 코드는 캐시 호스트 이름과 키 환경 변수를 사용하여 Azure Cache for Redis 인스턴스에 연결하는 방법을 보여 줍니다. 코드는 또한 캐시에 문자열 값을 저장하고 검색합니다. 또한 PING 및 CLIENT LIST 명령을 실행했습니다. node_redis 클라이언트가 포함된 Redis 사용에 관한 더 많은 예는 Node-Redis를 참조하세요.

3. Node.js를 사용하여 스크립트를 실행합니다.

   node redistest.js
   

4. 출력이 다음 예제와 비슷한지 확인합니다.

   Cache command: PING
   Cache response : PONG
   
   Cache command: GET Message
   Cache response : Hello! The cache is working from Node.js!
   
   Cache command: SET Message
   Cache response : OK
   
   Cache command: GET Message
   Cache response : Hello! The cache is working from Node.js!
   
   Cache command: CLIENT LIST
   Cache response : id=10017364 addr=76.22.73.183:59380 fd=221 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 argv-mem=10 obl=0 oll=0 omem=0 tot-mem=61466 ow=0 owmem=0 events=r cmd=client user=default numops=6
   
   Done