In May 2016, we released the newest version of Google Identity Toolkit as Firebase Authentication, and in April 2019, we released Google Cloud's Identity Platform. These products include upgraded client SDKs, open source UI libraries, session management and integrated email sending service for forgotten password flows.

On June 30, 2020, the SDKs documented on this page and the API setting page will stop functioning. (The https://identitytoolkit.googleapis.com/... and https://securetoken.googleapis.com/... endpoints, used by Identity Platform and Firebase Authentication, will continue to function.)

To migrate an existing project from Identity Toolkit, see the Identity Platform migration guide or Firebase Authentication migration guide.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.
Switch to English

Python 용 빠른 시작 앱

이 빠른 시작을 통해 약 30 분 만에 Python에서 Google Identity Toolkit을 시작할 수 있습니다.

시작하기 전에 다음이 필요합니다.

  • 파이썬 2.7

1 단계 : Google Identity Toolkit API 구성

이 빠른 시작 가이드는 사용자 이름 / 비밀번호, Google, Yahoo 및 (선택 사항) Facebook 로그인을 허용하는 기본 웹 사이트를 설정합니다.

  1. Google API 콘솔 API 라이브러리로 이동합니다.
  2. 프로젝트 드롭 다운에서 기존 프로젝트를 선택하거나 새 프로젝트 를 만듭니다. API 콘솔은 관련 웹 사이트, Android 앱 및 iOS 앱을 번들로 제공하는 '프로젝트'별로 정보를 그룹화합니다. Identity Toolkit API의 경우 동일한 프로젝트의 모든 웹 사이트 또는 앱이 동일한 사용자 데이터베이스를 공유합니다.
  3. Identity Toolkit API 서비스를 활성화합니다.
    1. Google API 목록에서 Identity Toolkit API 서비스를 검색합니다.
    2. 결과 목록에서 Identity Toolkit API 를 선택합니다.
    3. API 사용을 선택 합니다 .
    프로세스가 완료되면 활성화 된 API 목록에 Identity Toolkit API 가 나타납니다. 목록을 보려면 왼쪽 사이드 바 메뉴에서 API 및 서비스 를 선택한 다음 활성화 된 API 탭을 선택합니다.
  4. 다음으로 사용자의 이메일 주소를 요청할 때 Google이 사용자에게 표시 할 화면을 설정해야합니다. 'API 및 서비스'의 왼쪽 메뉴에서 자격증 명 을 선택한 다음 OAuth 동의 화면 탭을 선택합니다.
    1. 이메일 주소를 선택하고 제품 이름으로 웹 사이트 / 앱의 이름을 입력 한 다음 저장을 선택합니다.
    저장되면 자격 증명 탭으로 이동합니다.
  5. 다음으로 로그인을 위해 Google을 허용하는 앱으로 등록하기 위해 OAuth2 클라이언트 ID를 설정합니다.
    1. 자격 증명 탭에서 자격 증명 만들기 드롭 다운을 선택한 다음 OAuth 클라이언트 ID를 선택합니다.
    2. 응용 프로그램 유형 에서 웹 응용 프로그램을 선택 합니다 . 일부 ID 공급자에는 기본 SDK가 없기 때문에 현재 모바일 전용 애플리케이션에서도 전체 기능을 사용하려면 웹 서버가 필요합니다.
    3. 클라이언트 ID 이름 을 입력 한 다음 아래 설명 된 제한 사항 을 입력합니다.
      • 승인 된 JavaScript 출처
        이 빠른 시작 앱의 경우 http://localhost:8000
        귀하의 사이트 URL입니다. 예를 들어 사이트가 https://yoursite.com이면 상자에 입력합니다. (여러 URL에서 사이트에 액세스 할 수있는 경우 여러 항목을 추가 할 수 있습니다.)
      • 승인 된 리디렉션 URI
        이 빠른 시작 앱의 경우 http://localhost:8000/widget
        사용자에게 Google 또는 Yahoo와 같은 ID 공급자를 통해 인증하도록 보내는 경우 ID 공급자는 인증이 완료 될 때 돌아갈 페이지가 필요합니다. 일반적으로이를 승인 된 리디렉션 또는 콜백이라고합니다. Identity Toolkit을 사용하면 로그인 페이지가 표시됩니다. 원하는 URL을 사용할 수 있습니다. (일반적으로 https://yoursite.com/callback은 다른 것을 선호하지 않는 한 괜찮습니다)
    4. 이 필드를 완료했으면 만들기를 선택합니다.
  6. 이제 서비스 계정을 만듭니다.
    1. 자격 증명 만들기 드롭 다운을 다시 선택한 다음 (아직 자격 증명 탭에 있어야 함) 서비스 계정 키 를 선택 합니다 .
    2. 서비스 계정 드롭 다운에서 기존 서비스 계정을 선택하거나 새 계정을 만듭니다.
    3. 키 유형 에서 P12 키 옵션을 선택한 다음 만들기 를 선택합니다. 파일이 자동으로 컴퓨터에 다운로드됩니다.
    4. 팝업 창에서 개인 키의 비밀번호 를 기록한 다음 닫기를 선택합니다. 방금 다운로드 한 * .p12 파일을 선택한 디렉토리에 넣으십시오. 이 디렉토리는 비공개 (누구도 액세스 할 수 없음) 여야하지만 웹 서버 코드에 액세스 할 수 있어야합니다.
  7. 다음으로 앱이 Google API에 액세스 할 수 있도록 브라우저 API 키를 만듭니다.
    1. 자격 증명 만들기 드롭 다운을 선택한 다음 API 키 를 선택 합니다 .
    2. '새 키 만들기'팝업에서 브라우저 키를 선택하고 선택적으로 사이트의 URL을 허용 된 리퍼러로 설정합니다.
    3. 만들기를 선택합니다.
  8. 거의 완료되었습니다! 지원할 로그인 옵션을 결정하기 만하면됩니다.
    1. 왼쪽 메뉴에서 API 및 서비스 를 선택하여 API 목록으로 돌아갑니다.
    2. 사용 가능한 API 탭을 선택하십시오.
    3. 활성화 된 API 목록에서 Identity Toolkit API 를 찾은 다음 이름 오른쪽에있는 톱니 바퀴 아이콘 을 선택합니다. 이 작업은 로그인 페이지 구성을 엽니 다.
      • 화면의 URL 구성 섹션에서 URL을 선언합니다.
        • 위젯 URL
          드롭 다운에서 URL을 선택합니다. 이것은 "Authorized Redirect URIs"에서 웹 응용 프로그램의 클라이언트 ID에 이전에 입력 한 URL입니다. 로그인 페이지가 표시되는 URL이며 ID 제공 업체에 "리디렉션 URI"로 등록하는 데 필요한 URL이기도합니다.
          이 빠른 시작 앱의 경우 다음으로 설정합니다. /widget
        • 로그인 성공 URL
          여기에서 사용자가 성공적으로 로그인 한 후 전송됩니다.이 URL은 Identity Toolkit API 토큰을 확인한 다음 적절하다고 판단되는 인증 세션을 시작해야합니다. 많은 웹 애플리케이션 프레임 워크가 세션 쿠키를 생성합니다.
          이 빠른 시작 앱의 경우 다음으로 설정합니다. /
        • 로그 아웃 URL
          사용자 카드 위젯을 사용하기로 선택한 경우 사용자가 로그 아웃 버튼을 클릭하면이 URL로 리디렉션됩니다.
          이 빠른 시작 앱의 경우 다음으로 설정합니다. /
        • 이메일 URL 보내기
          비밀번호 재설정 또는 이메일 변경을 확인하기 위해 사용자에게 연락해야하는 경우도 있습니다. 많은 이메일 제공 업체에서 사용중인 이메일 소스 확인으로 인해 이러한 이메일은 스팸 또는 의심스러운 것으로 표시되지 않도록 서버에서 발송되어야합니다. Identity Toolkit API는 이메일 주소 및 메시지 내용과 함께이 URL로 POST 요청을 보내며 이메일을 보내야합니다.
          이 빠른 시작 앱의 경우 다음으로 설정합니다. /
    4. 공급자 섹션에서 지원할 자격 증명 공급자를 선택합니다. 일부 ID 공급자는 등록이 필요합니다. 공급자 옵션 / 요구 사항을 보려면 공급자 이름 또는 아래쪽 화살표를 선택합니다.
    5. (선택 사항) Facebook 로그인 구성
      1. Facebook 개발자 페이지로 이동하여 등록하거나 로그인 한 다음 내 앱-> 새 앱 추가를 선택합니다.
      2. "웹 사이트"플랫폼 선택
      3. 빠른 시작의 "Setup SDK"부분에서 사이트 URL을 입력합니다. 이 데모의 경우 http://localhost:8000/widget 입니다. 다음을 클릭하십시오. 코드 조각을 사용할 필요가 없습니다.
      4. 앱이 설정되면 :
        • 앱 대시 보드로 이동하여 클라이언트 ID로 Facebook 앱 ID를 입력합니다.
        • API 콘솔 ID 툴킷 API 구성 페이지에서 Facebook을 공급자로 활성화하고 Facebook 앱 ID 및 앱 암호를 입력합니다.
    6. (선택 사항) Twitter 로그인 구성
      1. Twitter 애플리케이션 관리 페이지로 이동하여 새 앱을 만듭니다.
      2. "콜백 URL"에서 Identity Toolkit을 호스팅 할 URL을 작성해야합니다. 이 데모의 경우 http://127.0.0.1:8000/widget
      3. 앱이 생성되면 :
        • 앱 대시 보드에서 "키 및 액세스 토큰"으로 이동하여 소비자 키와 소비자 암호를 복사합니다.
        • 그런 다음 In the API Console Identity Toolkit API 구성 페이지에서 Twitter를 공급자로 활성화하고 소비자 키 및 암호를 붙여 넣습니다.
    7. 설정을 저장하십시오!
    8. 페이지 하단에 두 개의 코드 스 니펫이 있습니다. 첫 번째 스 니펫은 웹 사이트에서 JavaScript 구성을 쉽게 만드는 데 도움이됩니다. 두 번째 스 니펫은 서버 측 코드 디렉토리에 gitkit-server-config.json 으로 저장해야합니다.
    9. 사용하기 전에 서버 측 구성 파일을 추가로 구성해야합니다. 편집 할 파일을 열고 앞에서 다운로드 한 * .p12 또는 * .json 파일의 경로와 같도록 serviceAccountPrivateKeyFile 설정을 변경합니다. / 시작하고 * .p12 또는 * .json 파일의 전체 이름으로 끝나는 전체 경로를 사용해야합니다.

    2 단계 : 빠른 시작 설정

    1. GitHub에서 Google Identity Toolkit Python 빠른 시작 다운로드

      mkdir ~/quickstart
      cd ~/quickstart
      unzip identity-toolkit-python-master.zip
      

      빠른 시작 의 소스 코드 또는 Github의 클라이언트 라이브러리 를 찾을 수도 있습니다.

    2. 빠른 시작 폴더로 디렉터리를 변경합니다.

      cd identity-toolkit-python-master
      
    3. 이 빠른 시작의 요구 사항을 설치합니다.

      pip install -r requirements.txt
      
    4. 1 단계 끝에서 생성 한 gitkit-server-config.json 측 구성 파일 gitkit-server-config.json 폴더로 이동합니다.

    5. 이전에 Developer Console에서 다운로드 한 * .p12 파일의 전체 경로를 포함하도록 gitkit-server-config.json 을 편집 gitkit-server-config.json .

    3 단계 : Flask로 기본 사이트 구축

    1. 다운로드 한 폴더에서 두 개의 매우 간단한 템플릿 인 index.htmlwidget.html 을 렌더링하는 sample.py 라는 파일을 찾을 수 있습니다. 이러한 템플릿은 templates 디렉토리에 있습니다.

    2. 주석에 표시된대로 config 변수를 수정하여 widget.html 을 수정하십시오. Developer Console의 클라이언트 측 구성 파일에서 복사해야합니다. 예는 다음과 같습니다.

      <!DOCTYPE html>
      <html>
      <head>
      <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
      
      <!-- Copy and paste here the client configuration from Developer Console into the config variable -->
      
      <script type="text/javascript" src="//www.gstatic.com/authtoolkit/js/gitkit.js"></script>
      <link type="text/css" rel="stylesheet" href="//www.gstatic.com/authtoolkit/css/gitkit.css" />
      <script type="text/javascript">
        var config =
          // Copy and paste client configuration here
        ;
        // The HTTP POST body should be escaped by the server to prevent XSS
        window.google.identitytoolkit.start(
            '#gitkitWidgetDiv', // accepts any CSS selector
            config,
            '{{ POST_BODY }}');
      </script>
      
      <!-- End modification -->
      
      </head>
      <body>
      
      <!-- Include the sign in page widget with the matching 'gitkitWidgetDiv' id -->
      <div id="gitkitWidgetDiv"></div>
      <!-- End identity toolkit widget -->
      
      </body></html>
      
    3. 실행하여 웹 사이트 시작

      python sample.py
      
    4. http : // localhost : 8000 에서 페이지보기

    다음 단계