این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

امضای درخواست شناسه مشتری

مهم: طرح ممتاز پلتفرم Google Maps دیگر برای ثبت نام یا مشتریان جدید در دسترس نیست.

امضای دیجیتال

امضای دیجیتال چگونه کار می کند

امضاهای دیجیتال با استفاده از رمز امضای URL یا کلید رمزنگاری که در Google Cloud Console موجود است، تولید می‌شوند. این راز در اصل یک کلید خصوصی است که فقط بین شما و Google به اشتراک گذاشته می شود و منحصر به فرد برای شناسه مشتری شما است.

فرآیند امضا از یک الگوریتم رمزگذاری برای ترکیب URL و راز مشترک شما استفاده می کند. امضای منحصربه‌فرد به‌دست‌آمده به سرورهای ما اجازه می‌دهد تا تأیید کنند که هر سایتی که با استفاده از شناسه مشتری شما درخواست ایجاد می‌کند، مجاز به انجام این کار است.

امضای درخواست های شما

امضای درخواست های شما شامل مراحل زیر است:

مرحله 1: رمز امضای URL خود را دریافت کنید
مرحله 2: یک درخواست بدون امضا بسازید
مرحله 3: درخواست امضا شده را ایجاد کنید

مرحله 1: رمز امضای URL خود را دریافت کنید

برای دریافت رمز امضای URL پروژه خود:

به صفحه Client ID در Cloud Console بروید.
فیلد کلید حاوی رمز امضای نشانی اینترنتی شناسه مشتری فعلی شما است.

اگر نیاز دارید رمز امضای URL ID مشتری خود را بازسازی کنید، با پشتیبانی تماس بگیرید .

مرحله 2: درخواست امضا نشده خود را بسازید

نویسه‌هایی که در جدول زیر فهرست نشده‌اند باید با URL رمزگذاری شوند:

خلاصه کاراکترهای URL معتبر

تنظیم کنید	شخصیت ها	استفاده از URL
الفبایی	abcdefghijklm nopqrstuvwxyz ABCDEFGHIJKLM NOPQRSTUVWXYZ 0 1 2 3 4 5 6 7 8 9	رشته های متنی، استفاده از طرح ( `http` )، پورت ( `8080` )، و غیره.
بدون رزرو	- _ . ~	رشته های متنی
رزرو شده است	! * ' ( ) ; : @ & = + $ , / ? % # [ ]	کاراکترها و/یا رشته های متنی را کنترل کنید

همین امر در مورد هر کاراکتر در مجموعه Reserved صدق می کند، اگر آنها در یک رشته متن ارسال شوند. برای اطلاعات بیشتر، کاراکترهای ویژه را ببینید.

URL درخواست امضا نشده خود را بدون امضا بسازید.

مطمئن شوید که شناسه مشتری را نیز در پارامتر client قرار دهید. به عنوان مثال:

https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID

درخواست امضا شده را ایجاد کنید

برای اهداف عیب‌یابی، می‌توانید با استفاده از ابزارک موجود اکنون یک URL را امضا کنید، امضای دیجیتالی را به‌طور خودکار ایجاد کنید.

برای درخواست هایی که به صورت پویا تولید می شوند، به امضای سمت سرور نیاز دارید که به چند مرحله میانی اضافی نیاز دارد

در هر صورت، شما باید با یک URL درخواست مواجه شوید که یک پارامتر signature به انتهای آن اضافه شده است. به عنوان مثال:

https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID
&signature=BASE64_SIGNATURE

طرح پروتکل و بخش های میزبان URL را حذف کنید و فقط مسیر و پرس و جو را باقی بگذارید:

/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID

رمز امضای URL نمایش داده شده در یک Base64 اصلاح شده برای URL ها کدگذاری می شود.
از آنجایی که اکثر کتابخانه های رمزنگاری نیاز دارند که کلید در قالب بایت خام باشد، احتمالاً باید قبل از امضا، رمز امضای URL خود را در قالب خام اصلی آن رمزگشایی کنید.
درخواست حذف شده بالا را با استفاده از HMAC-SHA1 امضا کنید.
از آنجایی که اکثر کتابخانه های رمزنگاری امضایی را در قالب بایت خام تولید می کنند، باید امضای باینری حاصل را با استفاده از Base64 اصلاح شده برای URL ها تبدیل کنید تا آن را به چیزی که می تواند در URL ارسال شود تبدیل کنید.
توجه: Base64 اصلاح شده برای URL ها به ترتیب + و / و کاراکترهای Base64 استاندارد را با - و _ جایگزین می کند، به طوری که این Base64 دیگر نیازی به کدگذاری URL ندارند.
امضای کدگذاری شده با Base64 را به URL درخواست امضا نشده اصلی در پارامتر signature اضافه کنید. به عنوان مثال:
```
https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID
&signature=BASE64_SIGNATURE
```

برای نمونه‌هایی که روش‌های پیاده‌سازی امضای URL با استفاده از کد سمت سرور را نشان می‌دهند، به نمونه کد برای امضای URL در زیر مراجعه کنید.

کد نمونه برای امضای URL

بخش‌های زیر راه‌هایی را برای پیاده‌سازی امضای URL با استفاده از کد سمت سرور نشان می‌دهند. URL ها باید همیشه در سمت سرور امضا شوند تا از افشای راز امضای URL شما برای کاربران جلوگیری شود.

پایتون

مثال زیر از کتابخانه های استاندارد پایتون برای امضای URL استفاده می کند. (کد را دانلود کنید .)

#!/usr/bin/python
# -*- coding: utf-8 -*-
""" Signs a URL using a URL signing secret """

import hashlib
import hmac
import base64
import urllib.parse as urlparse


def sign_url(input_url=None, secret=None):
    """ Sign a request URL with a URL signing secret.
      Usage:
      from urlsigner import sign_url
      signed_url = sign_url(input_url=my_url, secret=SECRET)
      Args:
      input_url - The URL to sign
      secret    - Your URL signing secret
      Returns:
      The signed request URL
  """

    if not input_url or not secret:
        raise Exception("Both input_url and secret are required")

    url = urlparse.urlparse(input_url)

    # We only need to sign the path+query part of the string
    url_to_sign = url.path + "?" + url.query

    # Decode the private key into its binary format
    # We need to decode the URL-encoded private key
    decoded_key = base64.urlsafe_b64decode(secret)

    # Create a signature using the private key and the URL-encoded
    # string using HMAC SHA1. This signature will be binary.
    signature = hmac.new(decoded_key, str.encode(url_to_sign), hashlib.sha1)

    # Encode the binary signature into base64 for use within a URL
    encoded_signature = base64.urlsafe_b64encode(signature.digest())

    original_url = url.scheme + "://" + url.netloc + url.path + "?" + url.query

    # Return signed URL
    return original_url + "&signature=" + encoded_signature.decode()


if __name__ == "__main__":
    input_url = input("URL to Sign: ")
    secret = input("URL signing secret: ")
    print("Signed URL: " + sign_url(input_url, secret))

جاوا

مثال زیر از کلاس java.util.Base64 در دسترس از JDK 1.8 استفاده می کند - نسخه های قدیمی تر ممکن است نیاز به استفاده از Apache Commons یا مشابه داشته باشند. (کد را دانلود کنید .)

import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URI;
import java.net.URISyntaxException;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.util.Base64;  // JDK 1.8 only - older versions may need to use Apache Commons or similar.
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class UrlSigner {

  // Note: Generally, you should store your private key someplace safe
  // and read them into your code

  private static String keyString = "YOUR_PRIVATE_KEY";
  
  // The URL shown in these examples is a static URL which should already
  // be URL-encoded. In practice, you will likely have code
  // which assembles your URL from user or web service input
  // and plugs those values into its parameters.
  private static String urlString = "YOUR_URL_TO_SIGN";

  // This variable stores the binary key, which is computed from the string (Base64) key
  private static byte[] key;
  
  public static void main(String[] args) throws IOException,
    InvalidKeyException, NoSuchAlgorithmException, URISyntaxException {
    
    BufferedReader input = new BufferedReader(new InputStreamReader(System.in));
    
    String inputUrl, inputKey = null;

    // For testing purposes, allow user input for the URL.
    // If no input is entered, use the static URL defined above.    
    System.out.println("Enter the URL (must be URL-encoded) to sign: ");
    inputUrl = input.readLine();
    if (inputUrl.equals("")) {
      inputUrl = urlString;
    }
    
    // Convert the string to a URL so we can parse it
    URL url = new URL(inputUrl);
 
    // For testing purposes, allow user input for the private key.
    // If no input is entered, use the static key defined above.   
    System.out.println("Enter the Private key to sign the URL: ");
    inputKey = input.readLine();
    if (inputKey.equals("")) {
      inputKey = keyString;
    }
    
    UrlSigner signer = new UrlSigner(inputKey);
    String request = signer.signRequest(url.getPath(),url.getQuery());
    
    System.out.println("Signed URL :" + url.getProtocol() + "://" + url.getHost() + request);
  }
  
  public UrlSigner(String keyString) throws IOException {
    // Convert the key from 'web safe' base 64 to binary
    keyString = keyString.replace('-', '+');
    keyString = keyString.replace('_', '/');
    System.out.println("Key: " + keyString);
    // Base64 is JDK 1.8 only - older versions may need to use Apache Commons or similar.
    this.key = Base64.getDecoder().decode(keyString);
  }

  public String signRequest(String path, String query) throws NoSuchAlgorithmException,
    InvalidKeyException, UnsupportedEncodingException, URISyntaxException {
    
    // Retrieve the proper URL components to sign
    String resource = path + '?' + query;
    
    // Get an HMAC-SHA1 signing key from the raw key bytes
    SecretKeySpec sha1Key = new SecretKeySpec(key, "HmacSHA1");

    // Get an HMAC-SHA1 Mac instance and initialize it with the HMAC-SHA1 key
    Mac mac = Mac.getInstance("HmacSHA1");
    mac.init(sha1Key);

    // compute the binary signature for the request
    byte[] sigBytes = mac.doFinal(resource.getBytes());

    // base 64 encode the binary signature
    // Base64 is JDK 1.8 only - older versions may need to use Apache Commons or similar.
    String signature = Base64.getEncoder().encodeToString(sigBytes);
    
    // convert the signature to 'web safe' base 64
    signature = signature.replace('+', '-');
    signature = signature.replace('/', '_');
    
    return resource + "&signature=" + signature;
  }
}

Node JS

مثال زیر از ماژول‌های Node برای امضای URL استفاده می‌کند. (کد را دانلود کنید .)

'use strict'

const crypto = require('crypto');
const url = require('url');

/**
 * Convert from 'web safe' base64 to true base64.
 *
 * @param  {string} safeEncodedString The code you want to translate
 *                                    from a web safe form.
 * @return {string}
 */
function removeWebSafe(safeEncodedString) {
  return safeEncodedString.replace(/-/g, '+').replace(/_/g, '/');
}

/**
 * Convert from true base64 to 'web safe' base64
 *
 * @param  {string} encodedString The code you want to translate to a
 *                                web safe form.
 * @return {string}
 */
function makeWebSafe(encodedString) {
  return encodedString.replace(/\+/g, '-').replace(/\//g, '_');
}

/**
 * Takes a base64 code and decodes it.
 *
 * @param  {string} code The encoded data.
 * @return {string}
 */
function decodeBase64Hash(code) {
  // "new Buffer(...)" is deprecated. Use Buffer.from if it exists.
  return Buffer.from ? Buffer.from(code, 'base64') : new Buffer(code, 'base64');
}

/**
 * Takes a key and signs the data with it.
 *
 * @param  {string} key  Your unique secret key.
 * @param  {string} data The url to sign.
 * @return {string}
 */
function encodeBase64Hash(key, data) {
  return crypto.createHmac('sha1', key).update(data).digest('base64');
}

/**
 * Sign a URL using a secret key.
 *
 * @param  {string} path   The url you want to sign.
 * @param  {string} secret Your unique secret key.
 * @return {string}
 */
function sign(path, secret) {
  const uri = url.parse(path);
  const safeSecret = decodeBase64Hash(removeWebSafe(secret));
  const hashedSignature = makeWebSafe(encodeBase64Hash(safeSecret, uri.path));
  return url.format(uri) + '&signature=' + hashedSignature;
}

سی شارپ

مثال زیر از کتابخانه پیش‌فرض System.Security.Cryptography برای امضای درخواست URL استفاده می‌کند. توجه داشته باشید که ما باید کدگذاری پیش‌فرض Base64 را برای پیاده‌سازی نسخه ایمن URL تبدیل کنیم. (کد را دانلود کنید .)

using System;
using System.Collections.Generic;
using System.Security.Cryptography;
using System.Text;
using System.Text.RegularExpressions;
using System.Web;

namespace SignUrl {

  public struct GoogleSignedUrl {

    public static string Sign(string url, string keyString) {
      ASCIIEncoding encoding = new ASCIIEncoding();

      // converting key to bytes will throw an exception, need to replace '-' and '_' characters first.
      string usablePrivateKey = keyString.Replace("-", "+").Replace("_", "/");
      byte[] privateKeyBytes = Convert.FromBase64String(usablePrivateKey);

      Uri uri = new Uri(url);
      byte[] encodedPathAndQueryBytes = encoding.GetBytes(uri.LocalPath + uri.Query);

      // compute the hash
      HMACSHA1 algorithm = new HMACSHA1(privateKeyBytes);
      byte[] hash = algorithm.ComputeHash(encodedPathAndQueryBytes);

      // convert the bytes to string and make url-safe by replacing '+' and '/' characters
      string signature = Convert.ToBase64String(hash).Replace("+", "-").Replace("/", "_");
            
      // Add the signature to the existing URI.
      return uri.Scheme+"://"+uri.Host+uri.LocalPath + uri.Query +"&signature=" + signature;
    }
  }

  class Program {

    static void Main() {
    
      // Note: Generally, you should store your private key someplace safe
      // and read them into your code

      const string keyString = "YOUR_PRIVATE_KEY";
  
      // The URL shown in these examples is a static URL which should already
      // be URL-encoded. In practice, you will likely have code
      // which assembles your URL from user or web service input
      // and plugs those values into its parameters.
      const  string urlString = "YOUR_URL_TO_SIGN";
      
      string inputUrl = null;
      string inputKey = null;
    
      Console.WriteLine("Enter the URL (must be URL-encoded) to sign: ");
      inputUrl = Console.ReadLine();
      if (inputUrl.Length == 0) {
        inputUrl = urlString;
      }     
    
      Console.WriteLine("Enter the Private key to sign the URL: ");
      inputKey = Console.ReadLine();
      if (inputKey.Length == 0) {
        inputKey = keyString;
      }
      
      Console.WriteLine(GoogleSignedUrl.Sign(inputUrl,inputKey));
    }
  }
}

نمونه هایی در زبان های اضافی

نمونه هایی که زبان های بیشتری را پوشش می دهند در پروژه امضای url موجود است.

عیب یابی

اگر درخواست شامل یک امضای نامعتبر باشد، API یک خطای HTTP 403 (Forbidden) برمی‌گرداند. این خطا به احتمال زیاد در صورتی رخ می‌دهد که رمز امضای استفاده شده به شناسه سرویس گیرنده ارسال شده مرتبط نباشد، یا اگر ورودی غیرASCII قبل از امضا با URL رمزگذاری نشده باشد.

برای عیب‌یابی مشکل، URL درخواست را کپی کنید، پارامتر پرس و جو signature را حذف کنید، و یک امضای معتبر را طبق دستورالعمل‌های زیر ایجاد کنید:

برای ایجاد یک امضای دیجیتال با شناسه مشتری خود با استفاده از ابزارک زیر یک URL را امضا کنید :

همانطور که در مرحله 1 توضیح داده شد، رمز امضای URL ID مشتری خود را واکشی کنید: رمز امضای URL خود را دریافت کنید .
در قسمت URL ، URL درخواست امضا نشده خود را از مرحله 2: درخواست بدون امضا خود را بسازید .
در قسمت URL Signing Secret ، رمز امضای URL خود را از مرحله 2 قرار دهید.
یک امضای دیجیتال بر اساس URL درخواست امضا نشده و رمز امضای شما ایجاد می‌شود و به URL اصلی شما اضافه می‌شود.
فیلد URL امضا شده شما که ظاهر می شود حاوی URL امضا شده دیجیتالی شما خواهد بود.

مهم: طرح ممتاز پلتفرم Google Maps دیگر برای ثبت نام یا مشتریان جدید در دسترس نیست.

امضای دیجیتال

امضای دیجیتال چگونه کار می کند

امضای درخواست های شما

امضای درخواست های شما شامل مراحل زیر است:

مرحله 1: رمز امضای URL خود را دریافت کنید
مرحله 2: یک درخواست بدون امضا بسازید
مرحله 3: درخواست امضا شده را ایجاد کنید

مرحله 1: رمز امضای URL خود را دریافت کنید

برای دریافت رمز امضای URL پروژه خود:

به صفحه Client ID در Cloud Console بروید.
فیلد کلید حاوی رمز امضای نشانی اینترنتی شناسه مشتری فعلی شما است.

اگر نیاز دارید رمز امضای URL ID مشتری خود را بازسازی کنید، با پشتیبانی تماس بگیرید .

مرحله 2: درخواست امضا نشده خود را بسازید

نویسه‌هایی که در جدول زیر فهرست نشده‌اند باید با URL رمزگذاری شوند:

تنظیم کنید	شخصیت ها	استفاده از URL
الفبایی	abcdefghijklm nopqrstuvwxyz ABCDEFGHIJKLM NOPQRSTUVWXYZ 0 1 2 3 4 5 6 7 8 9	رشته های متنی، استفاده از طرح ( `http` )، پورت ( `8080` )، و غیره.
بدون رزرو	- _ . ~	رشته های متنی
رزرو شده است	! * ' ( ) ; : @ & = + $ , / ? % # [ ]	کاراکترها و/یا رشته های متنی را کنترل کنید

URL درخواست امضا نشده خود را بدون امضا بسازید.

مطمئن شوید که شناسه مشتری را نیز در پارامتر client قرار دهید. به عنوان مثال:

https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID

درخواست امضا شده را ایجاد کنید

در هر صورت، شما باید با یک URL درخواست مواجه شوید که یک پارامتر signature به انتهای آن اضافه شده است. به عنوان مثال:

https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID
&signature=BASE64_SIGNATURE

طرح پروتکل و بخش های میزبان URL را حذف کنید و فقط مسیر و پرس و جو را باقی بگذارید:

/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID

رمز امضای URL نمایش داده شده در یک Base64 اصلاح شده برای URL ها کدگذاری می شود.
از آنجایی که اکثر کتابخانه های رمزنگاری نیاز دارند که کلید در قالب بایت خام باشد، احتمالاً باید قبل از امضا، رمز امضای URL خود را در قالب خام اصلی آن رمزگشایی کنید.
درخواست حذف شده بالا را با استفاده از HMAC-SHA1 امضا کنید.
از آنجایی که اکثر کتابخانه های رمزنگاری امضایی را در قالب بایت خام تولید می کنند، باید امضای باینری حاصل را با استفاده از Base64 اصلاح شده برای URL ها تبدیل کنید تا آن را به چیزی که می تواند در URL ارسال شود تبدیل کنید.
توجه: Base64 اصلاح شده برای URL ها به ترتیب + و / و کاراکترهای Base64 استاندارد را با - و _ جایگزین می کند، به طوری که این Base64 دیگر نیازی به کدگذاری URL ندارند.
امضای کدگذاری شده با Base64 را به URL درخواست امضا نشده اصلی در پارامتر signature اضافه کنید. به عنوان مثال:
```
https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID
&signature=BASE64_SIGNATURE
```

کد نمونه برای امضای URL

پایتون

مثال زیر از کتابخانه های استاندارد پایتون برای امضای URL استفاده می کند. (کد را دانلود کنید .)

#!/usr/bin/python
# -*- coding: utf-8 -*-
""" Signs a URL using a URL signing secret """

import hashlib
import hmac
import base64
import urllib.parse as urlparse


def sign_url(input_url=None, secret=None):
    """ Sign a request URL with a URL signing secret.
      Usage:
      from urlsigner import sign_url
      signed_url = sign_url(input_url=my_url, secret=SECRET)
      Args:
      input_url - The URL to sign
      secret    - Your URL signing secret
      Returns:
      The signed request URL
  """

    if not input_url or not secret:
        raise Exception("Both input_url and secret are required")

    url = urlparse.urlparse(input_url)

    # We only need to sign the path+query part of the string
    url_to_sign = url.path + "?" + url.query

    # Decode the private key into its binary format
    # We need to decode the URL-encoded private key
    decoded_key = base64.urlsafe_b64decode(secret)

    # Create a signature using the private key and the URL-encoded
    # string using HMAC SHA1. This signature will be binary.
    signature = hmac.new(decoded_key, str.encode(url_to_sign), hashlib.sha1)

    # Encode the binary signature into base64 for use within a URL
    encoded_signature = base64.urlsafe_b64encode(signature.digest())

    original_url = url.scheme + "://" + url.netloc + url.path + "?" + url.query

    # Return signed URL
    return original_url + "&signature=" + encoded_signature.decode()


if __name__ == "__main__":
    input_url = input("URL to Sign: ")
    secret = input("URL signing secret: ")
    print("Signed URL: " + sign_url(input_url, secret))

جاوا

import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URI;
import java.net.URISyntaxException;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.util.Base64;  // JDK 1.8 only - older versions may need to use Apache Commons or similar.
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class UrlSigner {

  // Note: Generally, you should store your private key someplace safe
  // and read them into your code

  private static String keyString = "YOUR_PRIVATE_KEY";
  
  // The URL shown in these examples is a static URL which should already
  // be URL-encoded. In practice, you will likely have code
  // which assembles your URL from user or web service input
  // and plugs those values into its parameters.
  private static String urlString = "YOUR_URL_TO_SIGN";

  // This variable stores the binary key, which is computed from the string (Base64) key
  private static byte[] key;
  
  public static void main(String[] args) throws IOException,
    InvalidKeyException, NoSuchAlgorithmException, URISyntaxException {
    
    BufferedReader input = new BufferedReader(new InputStreamReader(System.in));
    
    String inputUrl, inputKey = null;

    // For testing purposes, allow user input for the URL.
    // If no input is entered, use the static URL defined above.    
    System.out.println("Enter the URL (must be URL-encoded) to sign: ");
    inputUrl = input.readLine();
    if (inputUrl.equals("")) {
      inputUrl = urlString;
    }
    
    // Convert the string to a URL so we can parse it
    URL url = new URL(inputUrl);
 
    // For testing purposes, allow user input for the private key.
    // If no input is entered, use the static key defined above.   
    System.out.println("Enter the Private key to sign the URL: ");
    inputKey = input.readLine();
    if (inputKey.equals("")) {
      inputKey = keyString;
    }
    
    UrlSigner signer = new UrlSigner(inputKey);
    String request = signer.signRequest(url.getPath(),url.getQuery());
    
    System.out.println("Signed URL :" + url.getProtocol() + "://" + url.getHost() + request);
  }
  
  public UrlSigner(String keyString) throws IOException {
    // Convert the key from 'web safe' base 64 to binary
    keyString = keyString.replace('-', '+');
    keyString = keyString.replace('_', '/');
    System.out.println("Key: " + keyString);
    // Base64 is JDK 1.8 only - older versions may need to use Apache Commons or similar.
    this.key = Base64.getDecoder().decode(keyString);
  }

  public String signRequest(String path, String query) throws NoSuchAlgorithmException,
    InvalidKeyException, UnsupportedEncodingException, URISyntaxException {
    
    // Retrieve the proper URL components to sign
    String resource = path + '?' + query;
    
    // Get an HMAC-SHA1 signing key from the raw key bytes
    SecretKeySpec sha1Key = new SecretKeySpec(key, "HmacSHA1");

    // Get an HMAC-SHA1 Mac instance and initialize it with the HMAC-SHA1 key
    Mac mac = Mac.getInstance("HmacSHA1");
    mac.init(sha1Key);

    // compute the binary signature for the request
    byte[] sigBytes = mac.doFinal(resource.getBytes());

    // base 64 encode the binary signature
    // Base64 is JDK 1.8 only - older versions may need to use Apache Commons or similar.
    String signature = Base64.getEncoder().encodeToString(sigBytes);
    
    // convert the signature to 'web safe' base 64
    signature = signature.replace('+', '-');
    signature = signature.replace('/', '_');
    
    return resource + "&signature=" + signature;
  }
}

Node JS

مثال زیر از ماژول‌های Node برای امضای URL استفاده می‌کند. (کد را دانلود کنید .)

'use strict'

const crypto = require('crypto');
const url = require('url');

/**
 * Convert from 'web safe' base64 to true base64.
 *
 * @param  {string} safeEncodedString The code you want to translate
 *                                    from a web safe form.
 * @return {string}
 */
function removeWebSafe(safeEncodedString) {
  return safeEncodedString.replace(/-/g, '+').replace(/_/g, '/');
}

/**
 * Convert from true base64 to 'web safe' base64
 *
 * @param  {string} encodedString The code you want to translate to a
 *                                web safe form.
 * @return {string}
 */
function makeWebSafe(encodedString) {
  return encodedString.replace(/\+/g, '-').replace(/\//g, '_');
}

/**
 * Takes a base64 code and decodes it.
 *
 * @param  {string} code The encoded data.
 * @return {string}
 */
function decodeBase64Hash(code) {
  // "new Buffer(...)" is deprecated. Use Buffer.from if it exists.
  return Buffer.from ? Buffer.from(code, 'base64') : new Buffer(code, 'base64');
}

/**
 * Takes a key and signs the data with it.
 *
 * @param  {string} key  Your unique secret key.
 * @param  {string} data The url to sign.
 * @return {string}
 */
function encodeBase64Hash(key, data) {
  return crypto.createHmac('sha1', key).update(data).digest('base64');
}

/**
 * Sign a URL using a secret key.
 *
 * @param  {string} path   The url you want to sign.
 * @param  {string} secret Your unique secret key.
 * @return {string}
 */
function sign(path, secret) {
  const uri = url.parse(path);
  const safeSecret = decodeBase64Hash(removeWebSafe(secret));
  const hashedSignature = makeWebSafe(encodeBase64Hash(safeSecret, uri.path));
  return url.format(uri) + '&signature=' + hashedSignature;
}

سی شارپ

using System;
using System.Collections.Generic;
using System.Security.Cryptography;
using System.Text;
using System.Text.RegularExpressions;
using System.Web;

namespace SignUrl {

  public struct GoogleSignedUrl {

    public static string Sign(string url, string keyString) {
      ASCIIEncoding encoding = new ASCIIEncoding();

      // converting key to bytes will throw an exception, need to replace '-' and '_' characters first.
      string usablePrivateKey = keyString.Replace("-", "+").Replace("_", "/");
      byte[] privateKeyBytes = Convert.FromBase64String(usablePrivateKey);

      Uri uri = new Uri(url);
      byte[] encodedPathAndQueryBytes = encoding.GetBytes(uri.LocalPath + uri.Query);

      // compute the hash
      HMACSHA1 algorithm = new HMACSHA1(privateKeyBytes);
      byte[] hash = algorithm.ComputeHash(encodedPathAndQueryBytes);

      // convert the bytes to string and make url-safe by replacing '+' and '/' characters
      string signature = Convert.ToBase64String(hash).Replace("+", "-").Replace("/", "_");
            
      // Add the signature to the existing URI.
      return uri.Scheme+"://"+uri.Host+uri.LocalPath + uri.Query +"&signature=" + signature;
    }
  }

  class Program {

    static void Main() {
    
      // Note: Generally, you should store your private key someplace safe
      // and read them into your code

      const string keyString = "YOUR_PRIVATE_KEY";
  
      // The URL shown in these examples is a static URL which should already
      // be URL-encoded. In practice, you will likely have code
      // which assembles your URL from user or web service input
      // and plugs those values into its parameters.
      const  string urlString = "YOUR_URL_TO_SIGN";
      
      string inputUrl = null;
      string inputKey = null;
    
      Console.WriteLine("Enter the URL (must be URL-encoded) to sign: ");
      inputUrl = Console.ReadLine();
      if (inputUrl.Length == 0) {
        inputUrl = urlString;
      }     
    
      Console.WriteLine("Enter the Private key to sign the URL: ");
      inputKey = Console.ReadLine();
      if (inputKey.Length == 0) {
        inputKey = keyString;
      }
      
      Console.WriteLine(GoogleSignedUrl.Sign(inputUrl,inputKey));
    }
  }
}

نمونه هایی در زبان های اضافی

نمونه هایی که زبان های بیشتری را پوشش می دهند در پروژه امضای url موجود است.

عیب یابی

برای ایجاد یک امضای دیجیتال با شناسه مشتری خود با استفاده از ابزارک زیر یک URL را امضا کنید :

همانطور که در مرحله 1 توضیح داده شد، رمز امضای URL ID مشتری خود را واکشی کنید: رمز امضای URL خود را دریافت کنید .
در قسمت URL ، URL درخواست امضا نشده خود را از مرحله 2: درخواست بدون امضا خود را بسازید .
در قسمت URL Signing Secret ، رمز امضای URL خود را از مرحله 2 قرار دهید.
یک امضای دیجیتال بر اساس URL درخواست امضا نشده و رمز امضای شما ایجاد می‌شود و به URL اصلی شما اضافه می‌شود.
فیلد URL امضا شده شما که ظاهر می شود حاوی URL امضا شده دیجیتالی شما خواهد بود.

مهم: طرح ممتاز پلتفرم Google Maps دیگر برای ثبت نام یا مشتریان جدید در دسترس نیست.

امضای دیجیتال

امضای دیجیتال چگونه کار می کند

امضای درخواست های شما

امضای درخواست های شما شامل مراحل زیر است:

مرحله 1: رمز امضای URL خود را دریافت کنید
مرحله 2: یک درخواست بدون امضا بسازید
مرحله 3: درخواست امضا شده را ایجاد کنید

مرحله 1: رمز امضای URL خود را دریافت کنید

برای دریافت رمز امضای URL پروژه خود:

به صفحه Client ID در Cloud Console بروید.
فیلد کلید حاوی رمز امضای نشانی اینترنتی شناسه مشتری فعلی شما است.

اگر نیاز دارید رمز امضای URL ID مشتری خود را بازسازی کنید، با پشتیبانی تماس بگیرید .

مرحله 2: درخواست امضا نشده خود را بسازید

نویسه‌هایی که در جدول زیر فهرست نشده‌اند باید با URL رمزگذاری شوند:

تنظیم کنید	شخصیت ها	استفاده از URL
الفبایی	abcdefghijklm nopqrstuvwxyz ABCDEFGHIJKLM NOPQRSTUVWXYZ 0 1 2 3 4 5 6 7 8 9	رشته های متنی، استفاده از طرح ( `http` )، پورت ( `8080` )، و غیره.
بدون رزرو	- _ . ~	رشته های متنی
رزرو شده است	! * ' ( ) ; : @ & = + $ , / ? % # [ ]	کاراکترها و/یا رشته های متنی را کنترل کنید

URL درخواست امضا نشده خود را بدون امضا بسازید.

مطمئن شوید که شناسه مشتری را نیز در پارامتر client قرار دهید. به عنوان مثال:

https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID

درخواست امضا شده را ایجاد کنید

در هر صورت، شما باید با یک URL درخواست مواجه شوید که یک پارامتر signature به انتهای آن اضافه شده است. به عنوان مثال:

https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID
&signature=BASE64_SIGNATURE

طرح پروتکل و بخش های میزبان URL را حذف کنید و فقط مسیر و پرس و جو را باقی بگذارید:

/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID

رمز امضای URL نمایش داده شده در یک Base64 اصلاح شده برای URL ها کدگذاری می شود.
از آنجایی که اکثر کتابخانه های رمزنگاری نیاز دارند که کلید در قالب بایت خام باشد، احتمالاً باید قبل از امضا، رمز امضای URL خود را در قالب خام اصلی آن رمزگشایی کنید.
درخواست حذف شده بالا را با استفاده از HMAC-SHA1 امضا کنید.
از آنجایی که اکثر کتابخانه های رمزنگاری امضایی را در قالب بایت خام تولید می کنند، باید امضای باینری حاصل را با استفاده از Base64 اصلاح شده برای URL ها تبدیل کنید تا آن را به چیزی که می تواند در URL ارسال شود تبدیل کنید.
توجه: Base64 اصلاح شده برای URL ها به ترتیب + و / و کاراکترهای Base64 استاندارد را با - و _ جایگزین می کند، به طوری که این Base64 دیگر نیازی به کدگذاری URL ندارند.
امضای کدگذاری شده با Base64 را به URL درخواست امضا نشده اصلی در پارامتر signature اضافه کنید. به عنوان مثال:
```
https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID
&signature=BASE64_SIGNATURE
```

کد نمونه برای امضای URL

پایتون

مثال زیر از کتابخانه های استاندارد پایتون برای امضای URL استفاده می کند. (کد را دانلود کنید .)

#!/usr/bin/python
# -*- coding: utf-8 -*-
""" Signs a URL using a URL signing secret """

import hashlib
import hmac
import base64
import urllib.parse as urlparse


def sign_url(input_url=None, secret=None):
    """ Sign a request URL with a URL signing secret.
      Usage:
      from urlsigner import sign_url
      signed_url = sign_url(input_url=my_url, secret=SECRET)
      Args:
      input_url - The URL to sign
      secret    - Your URL signing secret
      Returns:
      The signed request URL
  """

    if not input_url or not secret:
        raise Exception("Both input_url and secret are required")

    url = urlparse.urlparse(input_url)

    # We only need to sign the path+query part of the string
    url_to_sign = url.path + "?" + url.query

    # Decode the private key into its binary format
    # We need to decode the URL-encoded private key
    decoded_key = base64.urlsafe_b64decode(secret)

    # Create a signature using the private key and the URL-encoded
    # string using HMAC SHA1. This signature will be binary.
    signature = hmac.new(decoded_key, str.encode(url_to_sign), hashlib.sha1)

    # Encode the binary signature into base64 for use within a URL
    encoded_signature = base64.urlsafe_b64encode(signature.digest())

    original_url = url.scheme + "://" + url.netloc + url.path + "?" + url.query

    # Return signed URL
    return original_url + "&signature=" + encoded_signature.decode()


if __name__ == "__main__":
    input_url = input("URL to Sign: ")
    secret = input("URL signing secret: ")
    print("Signed URL: " + sign_url(input_url, secret))

جاوا

import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URI;
import java.net.URISyntaxException;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.util.Base64;  // JDK 1.8 only - older versions may need to use Apache Commons or similar.
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class UrlSigner {

  // Note: Generally, you should store your private key someplace safe
  // and read them into your code

  private static String keyString = "YOUR_PRIVATE_KEY";
  
  // The URL shown in these examples is a static URL which should already
  // be URL-encoded. In practice, you will likely have code
  // which assembles your URL from user or web service input
  // and plugs those values into its parameters.
  private static String urlString = "YOUR_URL_TO_SIGN";

  // This variable stores the binary key, which is computed from the string (Base64) key
  private static byte[] key;
  
  public static void main(String[] args) throws IOException,
    InvalidKeyException, NoSuchAlgorithmException, URISyntaxException {
    
    BufferedReader input = new BufferedReader(new InputStreamReader(System.in));
    
    String inputUrl, inputKey = null;

    // For testing purposes, allow user input for the URL.
    // If no input is entered, use the static URL defined above.    
    System.out.println("Enter the URL (must be URL-encoded) to sign: ");
    inputUrl = input.readLine();
    if (inputUrl.equals("")) {
      inputUrl = urlString;
    }
    
    // Convert the string to a URL so we can parse it
    URL url = new URL(inputUrl);
 
    // For testing purposes, allow user input for the private key.
    // If no input is entered, use the static key defined above.   
    System.out.println("Enter the Private key to sign the URL: ");
    inputKey = input.readLine();
    if (inputKey.equals("")) {
      inputKey = keyString;
    }
    
    UrlSigner signer = new UrlSigner(inputKey);
    String request = signer.signRequest(url.getPath(),url.getQuery());
    
    System.out.println("Signed URL :" + url.getProtocol() + "://" + url.getHost() + request);
  }
  
  public UrlSigner(String keyString) throws IOException {
    // Convert the key from 'web safe' base 64 to binary
    keyString = keyString.replace('-', '+');
    keyString = keyString.replace('_', '/');
    System.out.println("Key: " + keyString);
    // Base64 is JDK 1.8 only - older versions may need to use Apache Commons or similar.
    this.key = Base64.getDecoder().decode(keyString);
  }

  public String signRequest(String path, String query) throws NoSuchAlgorithmException,
    InvalidKeyException, UnsupportedEncodingException, URISyntaxException {
    
    // Retrieve the proper URL components to sign
    String resource = path + '?' + query;
    
    // Get an HMAC-SHA1 signing key from the raw key bytes
    SecretKeySpec sha1Key = new SecretKeySpec(key, "HmacSHA1");

    // Get an HMAC-SHA1 Mac instance and initialize it with the HMAC-SHA1 key
    Mac mac = Mac.getInstance("HmacSHA1");
    mac.init(sha1Key);

    // compute the binary signature for the request
    byte[] sigBytes = mac.doFinal(resource.getBytes());

    // base 64 encode the binary signature
    // Base64 is JDK 1.8 only - older versions may need to use Apache Commons or similar.
    String signature = Base64.getEncoder().encodeToString(sigBytes);
    
    // convert the signature to 'web safe' base 64
    signature = signature.replace('+', '-');
    signature = signature.replace('/', '_');
    
    return resource + "&signature=" + signature;
  }
}

Node JS

مثال زیر از ماژول‌های Node برای امضای URL استفاده می‌کند. (کد را دانلود کنید .)

'use strict'

const crypto = require('crypto');
const url = require('url');

/**
 * Convert from 'web safe' base64 to true base64.
 *
 * @param  {string} safeEncodedString The code you want to translate
 *                                    from a web safe form.
 * @return {string}
 */
function removeWebSafe(safeEncodedString) {
  return safeEncodedString.replace(/-/g, '+').replace(/_/g, '/');
}

/**
 * Convert from true base64 to 'web safe' base64
 *
 * @param  {string} encodedString The code you want to translate to a
 *                                web safe form.
 * @return {string}
 */
function makeWebSafe(encodedString) {
  return encodedString.replace(/\+/g, '-').replace(/\//g, '_');
}

/**
 * Takes a base64 code and decodes it.
 *
 * @param  {string} code The encoded data.
 * @return {string}
 */
function decodeBase64Hash(code) {
  // "new Buffer(...)" is deprecated. Use Buffer.from if it exists.
  return Buffer.from ? Buffer.from(code, 'base64') : new Buffer(code, 'base64');
}

/**
 * Takes a key and signs the data with it.
 *
 * @param  {string} key  Your unique secret key.
 * @param  {string} data The url to sign.
 * @return {string}
 */
function encodeBase64Hash(key, data) {
  return crypto.createHmac('sha1', key).update(data).digest('base64');
}

/**
 * Sign a URL using a secret key.
 *
 * @param  {string} path   The url you want to sign.
 * @param  {string} secret Your unique secret key.
 * @return {string}
 */
function sign(path, secret) {
  const uri = url.parse(path);
  const safeSecret = decodeBase64Hash(removeWebSafe(secret));
  const hashedSignature = makeWebSafe(encodeBase64Hash(safeSecret, uri.path));
  return url.format(uri) + '&signature=' + hashedSignature;
}

سی شارپ

using System;
using System.Collections.Generic;
using System.Security.Cryptography;
using System.Text;
using System.Text.RegularExpressions;
using System.Web;

namespace SignUrl {

  public struct GoogleSignedUrl {

    public static string Sign(string url, string keyString) {
      ASCIIEncoding encoding = new ASCIIEncoding();

      // converting key to bytes will throw an exception, need to replace '-' and '_' characters first.
      string usablePrivateKey = keyString.Replace("-", "+").Replace("_", "/");
      byte[] privateKeyBytes = Convert.FromBase64String(usablePrivateKey);

      Uri uri = new Uri(url);
      byte[] encodedPathAndQueryBytes = encoding.GetBytes(uri.LocalPath + uri.Query);

      // compute the hash
      HMACSHA1 algorithm = new HMACSHA1(privateKeyBytes);
      byte[] hash = algorithm.ComputeHash(encodedPathAndQueryBytes);

      // convert the bytes to string and make url-safe by replacing '+' and '/' characters
      string signature = Convert.ToBase64String(hash).Replace("+", "-").Replace("/", "_");
            
      // Add the signature to the existing URI.
      return uri.Scheme+"://"+uri.Host+uri.LocalPath + uri.Query +"&signature=" + signature;
    }
  }

  class Program {

    static void Main() {
    
      // Note: Generally, you should store your private key someplace safe
      // and read them into your code

      const string keyString = "YOUR_PRIVATE_KEY";
  
      // The URL shown in these examples is a static URL which should already
      // be URL-encoded. In practice, you will likely have code
      // which assembles your URL from user or web service input
      // and plugs those values into its parameters.
      const  string urlString = "YOUR_URL_TO_SIGN";
      
      string inputUrl = null;
      string inputKey = null;
    
      Console.WriteLine("Enter the URL (must be URL-encoded) to sign: ");
      inputUrl = Console.ReadLine();
      if (inputUrl.Length == 0) {
        inputUrl = urlString;
      }     
    
      Console.WriteLine("Enter the Private key to sign the URL: ");
      inputKey = Console.ReadLine();
      if (inputKey.Length == 0) {
        inputKey = keyString;
      }
      
      Console.WriteLine(GoogleSignedUrl.Sign(inputUrl,inputKey));
    }
  }
}

نمونه هایی در زبان های اضافی

نمونه هایی که زبان های بیشتری را پوشش می دهند در پروژه امضای url موجود است.

عیب یابی

برای ایجاد یک امضای دیجیتال با شناسه مشتری خود با استفاده از ابزارک زیر یک URL را امضا کنید :

همانطور که در مرحله 1 توضیح داده شد، رمز امضای URL ID مشتری خود را واکشی کنید: رمز امضای URL خود را دریافت کنید .
در قسمت URL ، URL درخواست امضا نشده خود را از مرحله 2: درخواست بدون امضا خود را بسازید .
در قسمت URL Signing Secret ، رمز امضای URL خود را از مرحله 2 قرار دهید.
یک امضای دیجیتال بر اساس URL درخواست امضا نشده و رمز امضای شما ایجاد می‌شود و به URL اصلی شما اضافه می‌شود.
فیلد URL امضا شده شما که ظاهر می شود حاوی URL امضا شده دیجیتالی شما خواهد بود.

مهم: طرح ممتاز پلتفرم Google Maps دیگر برای ثبت نام یا مشتریان جدید در دسترس نیست.

امضای دیجیتال

امضای دیجیتال چگونه کار می کند

امضای درخواست های شما

امضای درخواست های شما شامل مراحل زیر است:

مرحله 1: رمز امضای URL خود را دریافت کنید
مرحله 2: یک درخواست بدون امضا بسازید
مرحله 3: درخواست امضا شده را ایجاد کنید

مرحله 1: رمز امضای URL خود را دریافت کنید

برای دریافت رمز امضای URL پروژه خود:

به صفحه Client ID در Cloud Console بروید.
فیلد کلید حاوی رمز امضای نشانی اینترنتی شناسه مشتری فعلی شما است.

اگر نیاز دارید رمز امضای URL ID مشتری خود را بازسازی کنید، با پشتیبانی تماس بگیرید .

مرحله 2: درخواست امضا نشده خود را بسازید

نویسه‌هایی که در جدول زیر فهرست نشده‌اند باید با URL رمزگذاری شوند:

تنظیم کنید	شخصیت ها	استفاده از URL
الفبایی	abcdefghijklm nopqrstuvwxyz ABCDEFGHIJKLM NOPQRSTUVWXYZ 0 1 2 3 4 5 6 7 8 9	رشته های متنی، استفاده از طرح ( `http` )، پورت ( `8080` )، و غیره.
بدون رزرو	- _ . ~	رشته های متنی
رزرو شده است	! * ' ( ) ; : @ & = + $ , / ? % # [ ]	کاراکترها و/یا رشته های متنی را کنترل کنید

URL درخواست امضا نشده خود را بدون امضا بسازید.

مطمئن شوید که شناسه مشتری را نیز در پارامتر client قرار دهید. به عنوان مثال:

https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID

درخواست امضا شده را ایجاد کنید

در هر صورت، شما باید با یک URL درخواست مواجه شوید که یک پارامتر signature به انتهای آن اضافه شده است. به عنوان مثال:

https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID
&signature=BASE64_SIGNATURE

طرح پروتکل و بخش های میزبان URL را حذف کنید و فقط مسیر و پرس و جو را باقی بگذارید:

/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID

رمز امضای URL نمایش داده شده در یک Base64 اصلاح شده برای URL ها کدگذاری می شود.
از آنجایی که اکثر کتابخانه های رمزنگاری نیاز دارند که کلید در قالب بایت خام باشد، احتمالاً باید قبل از امضا، رمز امضای URL خود را در قالب خام اصلی آن رمزگشایی کنید.
درخواست حذف شده بالا را با استفاده از HMAC-SHA1 امضا کنید.
از آنجایی که اکثر کتابخانه های رمزنگاری امضایی را در قالب بایت خام تولید می کنند، باید امضای باینری حاصل را با استفاده از Base64 اصلاح شده برای URL ها تبدیل کنید تا آن را به چیزی که می تواند در URL ارسال شود تبدیل کنید.
توجه: Base64 اصلاح شده برای URL ها به ترتیب + و / و کاراکترهای Base64 استاندارد را با - و _ جایگزین می کند، به طوری که این Base64 دیگر نیازی به کدگذاری URL ندارند.
امضای کدگذاری شده با Base64 را به URL درخواست امضا نشده اصلی در پارامتر signature اضافه کنید. به عنوان مثال:
```
https://maps.googleapis.com/maps/api/staticmap?center=Z%C3%BCrich&size=400x400&client=YOUR_CLIENT_ID
&signature=BASE64_SIGNATURE
```

کد نمونه برای امضای URL

پایتون

مثال زیر از کتابخانه های استاندارد پایتون برای امضای URL استفاده می کند. (کد را دانلود کنید .)

#!/usr/bin/python
# -*- coding: utf-8 -*-
""" Signs a URL using a URL signing secret """

import hashlib
import hmac
import base64
import urllib.parse as urlparse


def sign_url(input_url=None, secret=None):
    """ Sign a request URL with a URL signing secret.
      Usage:
      from urlsigner import sign_url
      signed_url = sign_url(input_url=my_url, secret=SECRET)
      Args:
      input_url - The URL to sign
      secret    - Your URL signing secret
      Returns:
      The signed request URL
  """

    if not input_url or not secret:
        raise Exception("Both input_url and secret are required")

    url = urlparse.urlparse(input_url)

    # We only need to sign the path+query part of the string
    url_to_sign = url.path + "?" + url.query

    # Decode the private key into its binary format
    # We need to decode the URL-encoded private key
    decoded_key = base64.urlsafe_b64decode(secret)

    # Create a signature using the private key and the URL-encoded
    # string using HMAC SHA1. This signature will be binary.
    signature = hmac.new(decoded_key, str.encode(url_to_sign), hashlib.sha1)

    # Encode the binary signature into base64 for use within a URL
    encoded_signature = base64.urlsafe_b64encode(signature.digest())

    original_url = url.scheme + "://" + url.netloc + url.path + "?" + url.query

    # Return signed URL
    return original_url + "&signature=" + encoded_signature.decode()


if __name__ == "__main__":
    input_url = input("URL to Sign: ")
    secret = input("URL signing secret: ")
    print("Signed URL: " + sign_url(input_url, secret))

جاوا

import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URI;
import java.net.URISyntaxException;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
import java.util.Base64;  // JDK 1.8 only - older versions may need to use Apache Commons or similar.
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class UrlSigner {

  // Note: Generally, you should store your private key someplace safe
  // and read them into your code

  private static String keyString = "YOUR_PRIVATE_KEY";
  
  // The URL shown in these examples is a static URL which should already
  // be URL-encoded. In practice, you will likely have code
  // which assembles your URL from user or web service input
  // and plugs those values into its parameters.
  private static String urlString = "YOUR_URL_TO_SIGN";

  // This variable stores the binary key, which is computed from the string (Base64) key
  private static byte[] key;
  
  public static void main(String[] args) throws IOException,
    InvalidKeyException, NoSuchAlgorithmException, URISyntaxException {
    
    BufferedReader input = new BufferedReader(new InputStreamReader(System.in));
    
    String inputUrl, inputKey = null;

    // For testing purposes, allow user input for the URL.
    // If no input is entered, use the static URL defined above.    
    System.out.println("Enter the URL (must be URL-encoded) to sign: ");
    inputUrl = input.readLine();
    if (inputUrl.equals("")) {
      inputUrl = urlString;
    }
    
    // Convert the string to a URL so we can parse it
    URL url = new URL(inputUrl);
 
    // For testing purposes, allow user input for the private key.
    // If no input is entered, use the static key defined above.   
    System.out.println("Enter the Private key to sign the URL: ");
    inputKey = input.readLine();
    if (inputKey.equals("")) {
      inputKey = keyString;
    }
    
    UrlSigner signer = new UrlSigner(inputKey);
    String request = signer.signRequest(url.getPath(),url.getQuery());
    
    System.out.println("Signed URL :" + url.getProtocol() + "://" + url.getHost() + request);
  }
  
  public UrlSigner(String keyString) throws IOException {
    // Convert the key from 'web safe' base 64 to binary
    keyString = keyString.replace('-', '+');
    keyString = keyString.replace('_', '/');
    System.out.println("Key: " + keyString);
    // Base64 is JDK 1.8 only - older versions may need to use Apache Commons or similar.
    this.key = Base64.getDecoder().decode(keyString);
  }

  public String signRequest(String path, String query) throws NoSuchAlgorithmException,
    InvalidKeyException, UnsupportedEncodingException, URISyntaxException {
    
    // Retrieve the proper URL components to sign
    String resource = path + '?' + query;
    
    // Get an HMAC-SHA1 signing key from the raw key bytes
    SecretKeySpec sha1Key = new SecretKeySpec(key, "HmacSHA1");

    // Get an HMAC-SHA1 Mac instance and initialize it with the HMAC-SHA1 key
    Mac mac = Mac.getInstance("HmacSHA1");
    mac.init(sha1Key);

    // compute the binary signature for the request
    byte[] sigBytes = mac.doFinal(resource.getBytes());

    // base 64 encode the binary signature
    // Base64 is JDK 1.8 only - older versions may need to use Apache Commons or similar.
    String signature = Base64.getEncoder().encodeToString(sigBytes);
    
    // convert the signature to 'web safe' base 64
    signature = signature.replace('+', '-');
    signature = signature.replace('/', '_');
    
    return resource + "&signature=" + signature;
  }
}

Node JS

مثال زیر از ماژول‌های Node برای امضای URL استفاده می‌کند. (کد را دانلود کنید .)

'use strict'

const crypto = require('crypto');
const url = require('url');

/**
 * Convert from 'web safe' base64 to true base64.
 *
 * @param  {string} safeEncodedString The code you want to translate
 *                                    from a web safe form.
 * @return {string}
 */
function removeWebSafe(safeEncodedString) {
  return safeEncodedString.replace(/-/g, '+').replace(/_/g, '/');
}

/**
 * Convert from true base64 to 'web safe' base64
 *
 * @param  {string} encodedString The code you want to translate to a
 *                                web safe form.
 * @return {string}
 */
function makeWebSafe(encodedString) {
  return encodedString.replace(/\+/g, '-').replace(/\//g, '_');
}

/**
 * Takes a base64 code and decodes it.
 *
 * @param  {string} code The encoded data.
 * @return {string}
 */
function decodeBase64Hash(code) {
  // "new Buffer(...)" is deprecated. Use Buffer.from if it exists.
  return Buffer.from ? Buffer.from(code, 'base64') : new Buffer(code, 'base64');
}

/**
 * Takes a key and signs the data with it.
 *
 * @param  {string} key  Your unique secret key.
 * @param  {string} data The url to sign.
 * @return {string}
 */
function encodeBase64Hash(key, data) {
  return crypto.createHmac('sha1', key).update(data).digest('base64');
}

/**
 * Sign a URL using a secret key.
 *
 * @param  {string} path   The url you want to sign.
 * @param  {string} secret Your unique secret key.
 * @return {string}
 */
function sign(path, secret) {
  const uri = url.parse(path);
  const safeSecret = decodeBase64Hash(removeWebSafe(secret));
  const hashedSignature = makeWebSafe(encodeBase64Hash(safeSecret, uri.path));
  return url.format(uri) + '&signature=' + hashedSignature;
}

سی شارپ

using System;
using System.Collections.Generic;
using System.Security.Cryptography;
using System.Text;
using System.Text.RegularExpressions;
using System.Web;

namespace SignUrl {

  public struct GoogleSignedUrl {

    public static string Sign(string url, string keyString) {
      ASCIIEncoding encoding = new ASCIIEncoding();

      // converting key to bytes will throw an exception, need to replace '-' and '_' characters first.
      string usablePrivateKey = keyString.Replace("-", "+").Replace("_", "/");
      byte[] privateKeyBytes = Convert.FromBase64String(usablePrivateKey);

      Uri uri = new Uri(url);
      byte[] encodedPathAndQueryBytes = encoding.GetBytes(uri.LocalPath + uri.Query);

      // compute the hash
      HMACSHA1 algorithm = new HMACSHA1(privateKeyBytes);
      byte[] hash = algorithm.ComputeHash(encodedPathAndQueryBytes);

      // convert the bytes to string and make url-safe by replacing '+' and '/' characters
      string signature = Convert.ToBase64String(hash).Replace("+", "-").Replace("/", "_");
            
      // Add the signature to the existing URI.
      return uri.Scheme+"://"+uri.Host+uri.LocalPath + uri.Query +"&signature=" + signature;
    }
  }

  class Program {

    static void Main() {
    
      // Note: Generally, you should store your private key someplace safe
      // and read them into your code

      const string keyString = "YOUR_PRIVATE_KEY";
  
      // The URL shown in these examples is a static URL which should already
      // be URL-encoded. In practice, you will likely have code
      // which assembles your URL from user or web service input
      // and plugs those values into its parameters.
      const  string urlString = "YOUR_URL_TO_SIGN";
      
      string inputUrl = null;
      string inputKey = null;
    
      Console.WriteLine("Enter the URL (must be URL-encoded) to sign: ");
      inputUrl = Console.ReadLine();
      if (inputUrl.Length == 0) {
        inputUrl = urlString;
      }     
    
      Console.WriteLine("Enter the Private key to sign the URL: ");
      inputKey = Console.ReadLine();
      if (inputKey.Length == 0) {
        inputKey = keyString;
      }
      
      Console.WriteLine(GoogleSignedUrl.Sign(inputUrl,inputKey));
    }
  }
}

نمونه هایی در زبان های اضافی

نمونه هایی که زبان های بیشتری را پوشش می دهند در پروژه امضای url موجود است.

عیب یابی

برای ایجاد یک امضای دیجیتال با شناسه مشتری خود با استفاده از ابزارک زیر یک URL را امضا کنید :

همانطور که در مرحله 1 توضیح داده شد، رمز امضای URL ID مشتری خود را واکشی کنید: رمز امضای URL خود را دریافت کنید .
در قسمت URL ، URL درخواست امضا نشده خود را از مرحله 2: درخواست بدون امضا خود را بسازید .
در قسمت URL Signing Secret ، رمز امضای URL خود را از مرحله 2 قرار دهید.
یک امضای دیجیتال بر اساس URL درخواست امضا نشده و رمز امضای شما ایجاد می‌شود و به URL اصلی شما اضافه می‌شود.
فیلد URL امضا شده شما که ظاهر می شود حاوی URL امضا شده دیجیتالی شما خواهد بود.