GM/T 0069-2019Open identity authentication framework (English PDF)
开放的身份鉴别框架
This is a limited preview
Buy now to download the full PDF (80 pages)
Need quotation for your management?
Get a formal quotation for GM/T 0069-2019 in 30 minutes.
Issued by
State Administration of Cryptography
Level / Type
National · Recommended
Issue date
July 12, 2019
Implementation date
July 12, 2019
Scope
GM/T 0069-2019 is the English-translated version of 开放的身份鉴别框架.
GM/T 0069-2019 — This standard specifies the agreement framework for relying parties (network applications or services) to use the authentication function provided by the identity service provider to authenticate end users; defines the requirements of the entities involved in the agreement, the authentication protocol process, the access requirements of user information, as well as the encryption and signature requirements of protocol messages, etc. This standard applies to the development, testing, evaluation and procurement of user identification services in scenarios where end users access network applications.
Found what you need?
Document preview — GM/T 0069-2019
National Standard of the People's Republic of China
- ICS
- 35.040
Contents
- Foreword1
- Scope2
- Normative references3
- Public - key encryption algorithm4
- Overview5
- Overview6
- Requirements for security management user information7
- Requirements for security configuration protocol8
- Requirements for secure transmission and processing of protocol9
- Identification process type10
- Overview11
- Authorization code process steps12
- Authentication request13
- Authentication request validation14
- Authentication success response15
- Overview16
- ID token17
- Overview18
- Encrypted JSON token19
- Overview20
- Normal claim21
- User information successful response22
- Foreword23
- Overview24
- Normal claim25
- User information successful response26
Foreword
This standard was drafted in accordance with the rules given in GB/T 1.1-2009.
This standard was proposed by and shall be under the jurisdiction of the Cryptographic Industry Standardization Technical Committee.
Drafting organizations of this standard. Data and Communication Protection Research and Education Center of Chinese Academy of Sciences, Beijing Digital Certification Co., Ltd., China Electronics Standardization Institute, Institute of Software of Chinese Academy of Sciences, Beijing Tianrongxin Technology Co., Ltd.
1 Scope
This standard specifies the agreement framework for relying parties (network applications or services) to use the authentication function provided by the identity service provider to authenticate end users; defines the requirements of the entities involved in the agreement, the authentication protocol process, the access requirements of user information, as well as the encryption and signature requirements of protocol messages, etc.
This standard applies to the development, testing, evaluation and procurement of user identification services in scenarios where end users access network applications.
2 Normative references
The following documents are essential to the application of this document. For the dated documents, only the versions with the dates indicated are applicable to this document; for the undated documents, only the latest version (including all the amendments) are applicable to this standard.
GB/T 32905-2016 Information security technology SM3 cryptographic hash algorithm GB/T 32907-2016 Information security technology - SM4 block cipher algorithm GB/T 32918.2-2016 Elliptic curve public - Key cryptography - Part 2: Digital signature algorithm GB/T 32918.4-2016 Elliptic curve public - Key cryptography algorithm - Part
4 Public - key encryption algorithm
GM/T 0024-2014 SSL VPN specification GM/T 0068-2019 Open third party resource authorization protocol framework
3 Terms and definitions the following terms and definitions apply to this document.
Access token
The token issued by the authorization server, which is used to prove that an entity has the authority to access protected resources within a specific range.
Authentication request A request for the purpose of authenticating the identity of the end user.
Note. After the identity service provider receives the request sent by the relying party, it authenticates the terminal user.
Authentication code flow an identity authentication process suitable for relying parties with confidentiality capabilities to authenticate end users.
Authorization endpoint the endpoint on the authorization server used to interact with the end user, which is used to receive the identity credentials and authorization of the end user, meanwhile return the authorization to the relying party.
4 Abbreviations
The following abbreviations apply to this document.
HTTP. Hypertext Transfer Protocol HMAC. Hash-based Message Authentication Code
5 Overview
The identity authentication protocol framework specified in this standard allows the relying party to use the authentication service of the identity service provider to authenticate the end user. After the end user is successfully authenticated, the relying party can obtain the authorized user's identity information from the identity service provider.
6.1.1 Overview
The identity service provider is an entity that provides identity authentication services for end users who access the relying party and shall provide the following functions.
6.1.2 Requirements for security management user information
The identity service provider shall securely manage and store the user's identity information, including the subject identifier, name, avatar, gender, date of birth, email address, mobile phone number, residential address and other identity attributes that identify the user. The type of these attribute information is defined and required by the identity service provider according to service needs (see Appendix A).
6.1.3 Requirements for security configuration protocol
The identity service provider shall provide the necessary basic configuration (see Appendix B) to implement the protocol process. First, the identity service provider shall provide the issuer identifier (usually URI), so that the relying party can find the identity service provider when executing the identity service discovery protocol.
6.1.4 Requirements for secure transmission and processing of protocol
messages
7.1 Identification process type
This standard defines three types of identity authentication processes based on different types of relying parties and different needs. The authentication process is executed by the server of the identity service provider.
7.2.1 Overview
This section describes how to use the authorization code-based authentication process to authenticate the end user.
7.2.2 Authorization code process steps
The authorization code process includes the following steps.
7.2.3.1 Authentication request
The authentication request is constructed by the relying party and used to request the authorization server to authenticate the end user.
7.2.3.2 Authentication request validation
After receiving the request, the authorization server shall perform the following validation.
7.2.3.5 Authentication success response
After the end user successfully passes the identity authentication, the authorization endpoint of the identity service provider shall use the "authentication success response" message as defined in this clause to respond to the authentication request message sent by the relying party.
When using the authorization code authentication process, the authorization server shall send the authorization code to the relying party, usually through redirection. The authorization server adds the following parameters to the query component of the redirection endpoint URI (first use UTF-8 to encode the parameters; then use the "application/x-www-form-urlencoded" [RFC1867] format for encoding).
8.1.1 Overview
The protocol defined in this standard mainly involves three types of tokens. ID tokens, access tokens and refresh tokens.
8.1.2 ID token
The ID token is a JSON token containing the authorization claim of the end user;
the body part is a JSON object containing the claim of the end user. See Chapter 9 for the specific content of the claim.
The following is the declaration used in the ID token.
8.2.1 Overview
JSON token is a kind of Javascript object symbol, which is encoded based on the security token, to realize the cross-security domain sharing of identity information and security information. JSON tokens can be used to represent the request parameters of the relying party; it can also be used to represent the authorization information of the end user. The token user can sign and/or encrypt the information contained in the JSON token. If signing and encrypting at the same time, it needs to sign and then encrypt.
8.2.3 Encrypted JSON token
The encrypted JSON token shall contain three parts.
9.1.1 Overview
The claim is the data about the entity generated by the identity service provider, which can be used to express the user's identity attribute information. By passing the claim, the identity service provider provides the end user identity information to the relying party.
9.1.2 Normal claim
The normal claim is represented by a member in the JSON object. The claimed name is used as the member name; the claimed value is used as the member value. The specification defines a set of normal claims (see Appendix A). They can be returned in the user information response (see 9.3.3), or in the ID token (see 8.1.2).
9.3.3 User information successful response
The user information claim shall be returned as a member of a JSON object, unless the customer requires a signature and/or encrypted response during registration. It can return to the claim as defined in Appendix A, or it can return to the claim of the extension not defined in this standard.
GM/T 0069-2019
CRYPTOGRAPHIC INDUSTRY STANDARD ICS 35.040 L 80 Open identity authentication framework Issued on. JULY 12, 2019 Implemented on. JULY 12, 2019 Issued by. State Cryptography Administration
Table of Contents
Foreword... 4
Introduction... 5
1 Scope... 6
2 Normative references... 6
3 Terms and definitions... 7
4 Abbreviations... 11
5 Overview... 12
6 Entity requirements... 14
6.1 Requirements for identity service providers... 14
6.2 Requirements for relying party... 17
7 Identification process... 19
7.1 Identification process type... 19
7.2 Authorization code authentication process... 20
7.3 Implicit authentication flow... 36
7.4 Hybrid authentication flow... 41
7.5 Access token refresh mechanism... 47
8 Token... 49
8.1 Token type... 49
8.2 JSON token... 52
8.3 Token security protection requirements... 55
9 User information access... 57
9.1 Types of claims... 57
9.2 Language and writing claim... 60
9.3 User information endpoint... 60
9.4 User information request claim... 63
9.5 Stability and uniqueness of claim... 67
10 Signature and encryption requirements... 68
10.1 Overview... 68
10.2 Signature... 68
10.3 Encryption... 69
10.4 Entropy of symmetric key... 71
10.5 Order of signature and encryption... 71 Appendix A (Normative) Normal claim... 72 Appendix B (Informative) Basic configuration of identity service provider... 74 Appendix C (Informative) Relying party's registration information... 77 References... 80
Foreword
This standard was drafted in accordance with the rules given in GB/T 1.1-2009.
This standard was proposed by and shall be under the jurisdiction of the Cryptographic Industry Standardization Technical Committee.
Drafting organizations of this standard. Data and Communication Protection Research and Education Center of Chinese Academy of Sciences, Beijing Digital Certification Co., Ltd., China Electronics Standardization Institute, Institute of Software of Chinese Academy of Sciences, Beijing Tianrongxin Technology Co., Ltd.
9.1.1 Overview
The claim is the data about the entity generated by the identity service provider, which can be used to express the user's identity attribute information. By passing the claim, the identity service provider provides the end user identity information to the relying party.
9.1.2 Normal claim
The normal claim is represented by a member in the JSON object. The claimed name is used as the member name; the claimed value is used as the member value. The specification defines a set of normal claims (see Appendix A). They can be returned in the user information response (see 9.3.3), or in the ID token (see 8.1.2).
9.3.3 User information successful response
The user information claim shall be returned as a member of a JSON object, unless the customer requires a signature and/or encrypted response during registration. It can return to the claim as defined in Appendix A, or it can return to the claim of the extension not defined in this standard.
......
This preview omits tables, figures, formulas and parts of the technical clauses. The complete document — 80 pages — is available in the English PDF.
Referenced standards
Normative references
- GB/T 32905-2016Information security techniques - SM3 cryptographic hash algorithm
- GB/T 32907-2016Information security technology - SM4 block cipher algorithm
- GB/T 32918.2-2016Information security technology—Public key cryptographic algorithm SM2 based on elliptic curves—Part 2: Digital signature algorithm
- GB/T 32918.4-2016Information security technology—Public key cryptographic algorithm SM2 based on elliptic curves—Part 4: Public key encryption algorithm
How to Download GM/T 0069-2019
- 1
Add to cart
Click "Download PDF" on this page and choose "Buy this standard". You can add more standards before checkout.
- 2
Checkout
Enter your email and billing details. Payment is processed securely by Stripe (cards or bank transfer). Prefer bank details? Request a quotation (min. order $300).
- 3
Instant delivery (0–9 sec)
Delivery is automatic: within seconds of payment you'll receive an email with a secure download link. The link stays valid for 72 hours.
- 4
Invoice included
A tax invoice is attached to the confirmation email. Need a custom invoice? Contact us.
Related Standards
GB/T 32905-2016 — Information security techniques - SM3 cryptographic hash algorithm
GB/T 32907-2016 — Information security technology - SM4 block cipher algorithm
GB/T 32918.2-2016 — Information security technology—Public key cryptographic algorithm SM2 based on elliptic curves—Part 2: Digital signature algorithm
Secure payment via Stripe
Payments accepted
GM/T 0069-2019
$580.00