-->
Important This API is deprecated. New and existing software should start using Cryptography Next Generation APIs. Microsoft may remove this API in future releases.
The CryptGenKey

All the keys vary in length and the characters they contain, I'm wondering what the best approach is for generating an API key? I'm not asking for a specific language, just the general approach to creating keys, should they be an encryption of details of the users app, or a hash, or a hash of a random string, etc. If your application uses either of those, you'll need an API key, which must be included in calls to the API. An API key is a UUID generated for you by RANDOM.ORG and can look like the following: ebfb7ff0-b2f6-41c8-bef3-4fba17be410c. If you are an application developer, you would typically create one API key for each application you make that. Anonymous means no API key is required, function means a function specific API key is required. So in this case each function has its own keys. And admin means you are required to provide the special 'master' host key, which is a single key that can be used to call any function in your function app.

API Keys Using JSON Web Tokens as API Keys. Most APIs today use an API Key to authenticate legitimate clients. API Keys are very simple to use from the consumer perspective: You get an API key. If the API Key Required option is set to false and you don't execute the previous steps, any API key that's associated with an API stage isn't used for the method. Create an API key If you've already created or imported API keys for use with usage plans, you can skip this and the next procedure.

function generates a random cryptographic session key or a public/private key pair. A handle to the key or key pair is returned in phKey. This handle can then be used as needed with any CryptoAPI function that requires a key handle.

The calling application must specify the algorithm when calling this function. Because this algorithm type is kept bundled with the key, the application does not need to specify the algorithm later when the actual cryptographic operations are performed.

Syntax

Parameters

hProv

A handle to a cryptographic service provider (CSP) created by a call toCryptAcquireContext.

Algid

AnALG_ID value that identifies the algorithm for which the key is to be generated. Values for this parameter vary depending on the CSP used.

For ALG_ID values to use with the Microsoft Base Cryptographic Provider, seeBase Provider Algorithms.

For ALG_ID values to use with the Microsoft Strong Cryptographic Provider or the Microsoft Enhanced Cryptographic Provider, seeEnhanced Provider Algorithms.

For a Diffie-Hellman CSP, use one of the following values.

ValueMeaning
CALG_DH_EPHEM
Specifies an 'Ephemeral' Diffie-Hellman key.
CALG_DH_SF
Specifies a 'Store and Forward' Diffie-Hellman key.

In addition to generating session keys for symmetric algorithms, this function can also generate public/private key pairs. Each CryptoAPI client generally possesses two public/private key pairs. To generate one of these key pairs, set the Algid parameter to one of the following values.

ValueMeaning
AT_KEYEXCHANGE
Key exchange
AT_SIGNATURE
Digital signature
Note When key specifications AT_KEYEXCHANGE and AT_SIGNATURE are specified, the algorithm identifiers that are used to generate the key depend on the provider used. As a result, for these key specifications, the values returned from CryptGetKeyParam (when the KP_ALGID parameter is specified) depend on the provider used. To determine which algorithm identifier is used by the different providers for the key specs AT_KEYEXCHANGE and AT_SIGNATURE, see ALG_ID.

dwFlags

Specifies the type of key generated. The sizes of a session key, RSA signature key, and RSA key exchange keys can be set when the key is generated. The key size, representing the length of the key modulus in bits, is set with the upper 16 bits of this parameter. Thus, if a 2,048-bit RSA signature key is to be generated, the value 0x08000000 is combined with any other dwFlags predefined value with a bitwise-OR operation. The upper 16 bits of 0x08000000 is 0x0800, or decimal 2,048. The RSA1024BIT_KEY value can be used to specify a 1024-bit RSA key.

Due to changing export control restrictions, the default CSP and default key length may change between operating system versions. It is important that both the encryption and decryption use the same CSP and that the key length be explicitly set using the dwFlags parameter to ensure interoperability on different operating system platforms.

In particular, the default RSA Full Cryptographic Service Provider is the Microsoft RSA Strong Cryptographic Provider. The default DSS Signature Diffie-Hellman Cryptographic Service Provider is the Microsoft Enhanced DSS Diffie-Hellman Cryptographic Provider. Each of these CSPs has a default 128-bit symmetric key length for RC2 and RC4 and a 1,024-bit default key length for public key algorithms.

If the upper 16 bits is zero, the default key size is generated. If a key larger than the maximum or smaller than the minimum is specified, the call fails with the ERROR_INVALID_PARAMETER code.

The following table lists minimum, default, and maximum signature and exchange key lengths beginning with Windows XP.

Key type and providerMinimum lengthDefault lengthMaximum length
RSA Base Provider

Signature and ExchangeKeys

38451216,384
RSA Strong and Enhanced Providers

Signature and Exchange Keys

3841,02416,384
DSS Base Providers

Signature Keys

5121,0241,024
DSS Base Providers

Exchange Keys

Not applicableNot applicableNot applicable
DSS/DH Base Providers

Signature Keys

5121,0241,024
DSS/DH Base Providers

Exchange Keys

5125121,024
DSS/DH Enhanced Providers

Signature Keys

5121,0241,024
DSS/DH Enhanced Providers

Exchange Keys

5121,0244,096

Function To Generate Api Key Download

For session key lengths, see CryptDeriveKey.

For more information about keys generated using Microsoft providers, seeMicrosoft Cryptographic Service Providers.

The lower 16-bits of this parameter can be zero or a combination of one or more of the following values.

ValueMeaning
CRYPT_ARCHIVABLE
If this flag is set, the key can be exported until its handle is closed by a call to CryptDestroyKey. This allows newly generated keys to be exported upon creation for archiving or key recovery. After the handle is closed, the key is no longer exportable.
CRYPT_CREATE_IV
This flag is not used.
CRYPT_CREATE_SALT
If this flag is set, then the key is assigned a random salt value automatically. You can retrieve this salt value by using the CryptGetKeyParam function with the dwParam parameter set to KP_SALT.

If this flag is not set, then the key is given a salt value of zero.

When keys with nonzero salt values are exported (throughCryptExportKey), then the salt value must also be obtained and kept with the key BLOB.

CRYPT_DATA_KEY
This flag is not used.
CRYPT_EXPORTABLE
If this flag is set, then the key can be transferred out of the CSP into a key BLOB by using the CryptExportKey function. Because session keys generally must be exportable, this flag should usually be set when they are created.

If this flag is not set, then the key is not exportable. For a session key, this means that the key is available only within the current session and only the application that created it will be able to use it. For a public/private key pair, this means that the private key cannot be transported or backed up.

This flag applies only to session key and private key BLOBs. It does not apply to public keys, which are always exportable.

CRYPT_FORCE_KEY_PROTECTION_HIGH
This flag specifies strong key protection. When this flag is set, the user is prompted to enter a password for the key when the key is created. The user will be prompted to enter the password whenever this key is used.

This flag is only used by the CSPs that are provided by Microsoft. Third party CSPs will define their own behavior for strong key protection. /norton-360-activation-key-generator.html.

Specifying this flag causes the same result as calling this function with the CRYPT_USER_PROTECTED flag when strong key protection is specified in the system registry.

If this flag is specified and the provider handle in the hProv parameter was created by using the CRYPT_VERIFYCONTEXT or CRYPT_SILENT flag, this function will set the last error to NTE_SILENT_CONTEXT and return zero.

Windows Server 2003 and Windows XP: This flag is not supported.

CRYPT_KEK
This flag is not used.
CRYPT_INITIATOR
This flag is not used.
CRYPT_NO_SALT
This flag specifies that a no salt value gets allocated for a forty-bit symmetric key. For more information, see Salt Value Functionality.
CRYPT_ONLINE
This flag is not used.
CRYPT_PREGEN
This flag specifies an initial Diffie-Hellman or DSS key generation. This flag is useful only with Diffie-Hellman and DSS CSPs. When used, a default key length will be used unless a key length is specified in the upper 16 bits of the dwFlags parameter. If parameters that involve key lengths are set on a PREGEN Diffie-Hellman or DSS key using CryptSetKeyParam, the key lengths must be compatible with the key length set here.
CRYPT_RECIPIENT
This flag is not used.
CRYPT_SF
This flag is not used.
CRYPT_SGCKEY
This flag is not used.
CRYPT_USER_PROTECTED
If this flag is set, the user is notified through a dialog box or another method when certain actions are attempting to use this key. The precise behavior is specified by the CSP being used. If the provider context was opened with the CRYPT_SILENT flag set, using this flag causes a failure and the last error is set to NTE_SILENT_CONTEXT.
CRYPT_VOLATILE
This flag is not used.

phKey

Address to which the function copies the handle of the newly generated key. When you have finished using the key, delete the handle to the key by calling the CryptDestroyKey function.

Return value

Returns nonzero if successful or zero otherwise.

For extended error information, callGetLastError.

The error codes prefaced by 'NTE' are generated by the particular CSP being used. Some possible error codes are listed in the following table.

Return codeDescription
ERROR_INVALID_HANDLE
One of the parameters specifies a handle that is not valid.
ERROR_INVALID_PARAMETER
One of the parameters contains a value that is not valid. This is most often a pointer that is not valid.
NTE_BAD_ALGID
The Algid parameter specifies an algorithm that this CSP does not support.
NTE_BAD_FLAGS
The dwFlags parameter contains a value that is not valid.
NTE_BAD_UID
The hProv parameter does not contain a valid context handle.
NTE_FAIL
The function failed in some unexpected way.
NTE_SILENT_CONTEXT
The provider could not perform the action because the context was acquired as silent.

Remarks

If keys are generated for symmetricblock ciphers, the key, by default, is set up in cipher block chaining (CBC) mode with an initialization vector of zero. This cipher mode provides a good default method for bulk encrypting data. To change these parameters, use theCryptSetKeyParam function.

To choose an appropriate key length, the following methods are recommended:

  • Enumerate the algorithms that the CSP supports and get maximum and minimum key lengths for each algorithm. To do this, call CryptGetProvParam with PP_ENUMALGS_EX.
  • Use the minimum and maximum lengths to choose an appropriate key length. It is not always advisable to choose the maximum length because this can lead to performance issues.
  • After the desired key length has been chosen, use the upper 16 bits of the dwFlags parameter to specify the key length.

Examples

The following example shows the creation of a random session key. For an example that includes the complete context for this example, see Example C Program: Encrypting a File. For another example that uses this function, see Example C Program: Decrypting a File.

Generate Random Api Key

Requirements

Minimum supported clientWindows XP [desktop apps only]
Minimum supported serverWindows Server 2003 [desktop apps only]
Target PlatformWindows
Headerwincrypt.h
LibraryAdvapi32.lib
DLLAdvapi32.dll

See also

With the new rules and API version 3 changes YouTube is requiring all users that want to view videos outside of YouTubes website to register and create a Project to access the API. The good news is this process is fairly simple.

In order for you to get the YouTube feed working you need an API Key. Here is the process to obtain that.

  1. Go to https://developers.google.com/ and log in or create an account, if necessary.
  2. After logging in go to this link https://console.developers.google.com/project and click on the blue CREATE PROJECT button as depicted in the photo below. Wait a moment as google prepares your project.
  3. Fill in whatever Project Name you want.
  4. Then click GoogleAPIs link in the top left corner and then click the link option called “YouTube Data API.” It’s under YouTube API’s. You can see it highlighted in the photo below, bottom right.
  5. Now click on the “ENABLE” button.
  6. Next click on the blue ‘Go to Credentials’ button to the right.
  7. Choose the select option YouTube Data API v3 for the first select option and Web server(e.g. node js. Tomcat) for the second selection. Then choose Public data. Now click the blue button, “What credentials do I need?.”
  8. Almost done, wait for google to create your new project and you should see the screen below where you can copy your API Key.
  9. Paste the API Key in our YouTube Options menu page as depicted below.

VERY IMPORTANT: If you get an error notice the best thing to do we have found in the trials here is to absolutely delete the Public API access. Then add it again.

That’s it, you’re done!

Videos not working?
Trouble Shooting Tip for a non-listed registry provider while attempting to verify your website at Google. It turns out that the DNS CNAME entry for Google is required in some instances (when choosing “Other” from their registry provider list). It’s possible the old CNAME will block the new CNAME from working if you do not do this.