[swift] 아폴로 서버를 사용한 로그 인 메커니즘 구현 방법

15 Nov 2023

swift

아폴로(Apollo)는 GraphQL을 기반으로 한 서버 개발 플랫폼입니다. 로그인 기능은 대부분의 웹 애플리케이션에서 필수적인 기능 중 하나입니다. 이번 블로그 포스트에서는 아폴로 서버를 사용하여 로그인 메커니즘을 구현하는 방법을 알아보겠습니다.

1. 사용자 인증 모델 설계

로그인 기능을 구현하기 전에, 먼저 사용자 인증 모델을 설계해야 합니다. 사용자 인증 모델은 사용자 정보를 저장하고 인증 토큰을 생성하는 역할을 합니다. 아폴로 서버에서는 대부분의 인증 작업을 토큰 기반으로 처리하므로, 토큰 생성을 위한 함수도 구현해야 합니다.

2. 로그인 기능 구현

아폴로 서버에서 로그인 기능을 구현하기 위해서는 다음과 같은 단계를 따라야 합니다:

2.1. 사용자 인증 요청 처리

로그인 요청을 처리하기 위한 GraphQL Mutation을 작성해야 합니다. 이 Mutation은 사용자가 제공한 인증 정보를 검증하고, 유효한 경우 사용자 정보와 인증 토큰을 반환해야 합니다.

type Mutation {
  login(email: String!, password: String!): AuthPayload!
}

type AuthPayload {
  user: User!
  token: String!
}

2.2. 사용자 인증 처리 로직 구현

로그인 요청에 대한 처리 로직을 작성해야 합니다. 이 로직은 사용자가 제공한 인증 정보와 데이터베이스에 저장된 사용자 정보를 비교하여 검증해야 합니다. 검증이 성공한 경우, 해당 사용자에 대한 인증 토큰을 생성하고 반환해야 합니다.

func login(_ email: String, _ password: String) -> AuthPayload {
  // 사용자 인증 처리 로직 작성
  
  if isValidUser(email, password) {
    let user = getUserByEmail(email)
    let token = generateAuthToken(user)
    return AuthPayload(user: user, token: token)
  }
  
  // 인증 실패 시 예외 처리 등
}

func isValidUser(_ email: String, _ password: String) -> Bool {
  // 사용자 인증 검증 로직 작성
}

func getUserByEmail(_ email: String) -> User {
  // 이메일을 기반으로 사용자 정보 조회 로직 작성
}

func generateAuthToken(_ user: User) -> String {
  // 인증 토큰 생성 로직 작성
}

2.3. 로그인 기능 테스트

로그인 기능을 구현한 후에는 테스트를 진행해야 합니다. 적절한 테스트 케이스를 작성하여 로그인 요청에 대한 처리 결과를 확인해보세요.

3. 로그인 상태 유지

로그인 상태를 유지하기 위해서는 클라이언트로부터 전달된 인증 토큰을 검증하는 로직이 필요합니다. 이를 위해 아폴로 서버에서는 ‘미들웨어’를 사용할 수 있습니다.

3.1. 인증 미들웨어 설정

아폴로 서버에서 인증 미들웨어를 설정하여 클라이언트로부터 받은 토큰을 검증하는 로직을 작성합니다.

const { ApolloServer, AuthenticationError } = require('apollo-server');

const server = new ApolloServer({
  // 미들웨어 설정
  context: ({ req }) => {
    const token = req.headers.authorization || '';
    
    try {
      // 토큰 검증 및 사용자 정보 반환
      const user = verifyAuthToken(token);
      return { user };
    } catch (error) {
      throw new AuthenticationError('Invalid token.');
    }
  },
  // 스키마 및 리졸버 등 설정
});

3.2. 인증 상태 사용

인증된 사용자 정보는 요청의 context 객체를 통해 리졸버에서 사용할 수 있습니다.

type Query {
  me: User!
}

const resolvers = {
  Query: {
    me: (_, __, { user }) => {
      // 인증된 사용자 정보 활용
      if (user) {
        return user;
      }
      
      // 인증되지 않은 사용자 처리 등
    }
  }
}

결론

위에서 소개한 방법을 따라 아폴로 서버를 사용하여 로그인 메커니즘을 구현할 수 있습니다. 로그인 기능은 많은 웹 애플리케이션에서 필수적인 부분이므로, 안전하고 효율적인 구현이 필요합니다.