Клавиша в: Сочетания клавиш в приложениях

— это учетные данные, ориентированные на проект, которые служат двум целям:

• Идентификация проекта .
  Укажите приложение или проект, которые обращаются к API или SDK.
• Авторизация проекта .
  Проверьте, предоставлен ли вызывающему приложению доступ для вызова API или SDK и включил API или SDK в проекте.

Когда ключ API создается, он связывается с проектом. Идентифицируя вызывающего проекта, ключ API позволяет связать информацию об использовании с этим project и помогает гарантировать отклонение вызовов из других проектов.

Защита ключей API

Вы должны защитить ключи API в своем приложении для всех продуктов Google Maps Platform, которые ваше приложение использует. Вы можете защитить ключи API, указав ограничения и внедрение передовых методов, подходящих для API платформы Google Maps. в вашем приложении.Публичное раскрытие незащищенных учетных данных может привести к непреднамеренному использованию, что может привести к непредвиденным списаниям с вашего счета.

Следующие практики описывают стратегии, помогающие защитить ключи API. Применимые практики для отдельного продукта Google Maps Platform, например Maps JavaScript API, перечислены в разделе ключевых ограничений и рекомендаций API.

• Ограничьте свои ключи API. Вы можете лучше всего защитить свой ключ API, ограничив его определенными IP-адресами, URL-адресами реферера или мобильные приложения и специальные API, поскольку это значительно снижает влияние компрометации ключа.

  Вы можете указать приложения и ограничения API для ключа из консоли. открыв страницу учетных данных, а затем либо создав новый ключ API с желаемыми настройками или редактируя настройки ключа API. См. Раздел Ограничение ключей API для получения полной информации.

• Используйте независимые ключи API для разных приложений. Это ограничивает область действия каждого ключа. Если ключ API скомпрометирован, вы может удалить и отозвать затронутый ключ без необходимости обновления вашего другие ключи API.
• Удалите ненужные ключи API.

  Для удаления ключа API:

  1. Посетите панель учетных данных.
  2. Выберите ключ API, который вы хотите удалить.
  3. Нажмите кнопку Удалить в верхней части страницы.
  4. Когда появится всплывающее окно Удалить учетные данные , щелкните УДАЛИТЬ .

• Соблюдайте осторожность при регенерации ключей API. Если требуется время для переноса ваших приложений со старого ключа API на новый, регенерированный ключ API превышает 24 часа, экземпляры, которые не обновляются будут сломаны, поскольку они ссылаются на старый ключ, который уничтожен 24 часа после регенерации.

  При повторном создании ключа API происходит следующее:

  • Новый ключ является результатом процесса регенерации.
  • Новый ключ получает все ограничения от старого ключа.
  • Начинается 24-часовое окно с указанием количества времени до старый ключ уничтожен.

• Отслеживайте использование вашего API на предмет аномалий. Если вы заметите несанкционированное использование, поменяйте ключи и сообщите об этом в Google.

  Перед поворотом ключа сохраните ограничения, связанные с ключом, копирование их в файл.

• В приложениях, использующих API веб-службы Карт или Статические веб-API , используйте следующие методы для защиты ваших приложений и ключей API:

  • Не вставляйте ключи API или секреты подписи непосредственно в код. Вместо прямого встраивания ключей API или любой другой личной информации в коде вашего приложения поместите их в переменные среды или во включаемые файлы, которые хранится отдельно от основной части вашего кода — вне исходного репозитория вашего заявление.Затем, если вы поделитесь своим кодом, ключи API или секреты подписи не будут включены в общие файлы.
  • Не хранить ключи API или секреты подписи в файлах внутри исходное дерево вашего приложения. Если вы храните ключи API или любые другие частные информации в файлах, храните файлы вне дерева исходных кодов вашего приложения, чтобы гарантировать ваши ключи или другая личная информация не попадает в вашу систему управления исходным кодом. Это особенно важно, если вы используете общедоступную систему управления исходным кодом, такую ​​как GitHub.
  • Просмотрите свой код перед публичным выпуском Это. Убедитесь, что ваш код не содержит ключей API, секретов подписи или каких-либо другую личную информацию, прежде чем вы сделаете свой код общедоступным.

• В мобильных приложениях, использующих API веб-служб или Статические веб-API , рассмотрите один или несколько из следующих методов для дальнейшей защиты ваших ключей API или секреты подписания:

  • Используйте прокси-сервер. Прокси-сервер предоставляет надежный источник для взаимодействия с соответствующим API платформы Google Maps. Для большего информацию об использовании прокси-сервера см. Жизнь заместителя: использование прокси-серверов с клиентскими библиотеками Google Data API.

  • Скрыть или зашифровать ключ API или секрет подписи. Это усложняет очистку ключей API и других личных данных непосредственно из приложения.

  • Используйте закрепление ЦС или закрепление сертификата для проверки сервера ресурсы действительны. CA pinning проверяет, был ли выдан сертификат сервера доверенным центром сертификации и предотвращает атаки Man-In-The-Middle, которые могут привести третьему лицу, обнаружившему ваш ключ API. Прикрепление сертификата идет дальше, извлекая и проверка открытого ключа, включенного в сертификат сервера. Закрепление полезно для мобильных устройств клиенты, взаимодействующие напрямую с серверами Google, а также мобильные клиенты, обменивающиеся данными с собственным прокси-сервером разработчика.

    Для получения дополнительной информации см .:

Ограничение ключей API

API — это учетные данные, и с ними следует обращаться осторожно. Как минимум, следуйте приведенным ниже рекомендациям, чтобы сохранить свои ключи в безопасности, и чтобы убедиться, что у вас есть ограничения для уменьшения воздействия скомпрометированных ключей API.

Вы можете ограничить ключ API, указав ограничение приложения, или одно или несколько ограничений API.

Ограничения приложений ограничивают использование ключей API для определенных сайтов (IP-адрес и веб-сайт) или определенные платформы (Android и iOS). Ты можешь выберите не более одного ограничения из этой категории (см. API платформы Google Maps по платформам).

Ограничения API ограничивают использование ключей API для одной или нескольких платформ Google Maps API или SDK. Запросы на использование API или SDK, связанных с API ключ будет обработан. Запросы на использование API или SDK, не связанных с ключом API, будут провал.Для ключа API вы можете указать любое количество ограничений API. Убедитесь, что API или Пакеты SDK, связанные с ключом API, поддерживают ограничение приложения, установленное для этого ключа API.

Чтобы установить ограничение приложения для ключа API

1. Посетите панель учетных данных.
2. Выберите ключ API, для которого вы хотите установить ограничение. Откроется страница свойств ключа API.
3. В разделе Ключевые ограничения выберите Ограничения приложений .
   Выберите один из типов ограничения и поставьте запрошенная информация после списка ограничений.

   Тип ограничения	Описание
   HTTP-ссылки	Принимать запросы от списка предоставленных вами веб-сайтов. Под типами укажите один или несколько сайтов-рефереров. Подстановочный знак символы допустимы для обозначения похожих веб-сайтов. Например, *.google.com принимает все сайты, заканчивающиеся на google.com , например https://developers.google.com .
   IP-адреса	Принимать запросы из списка IP-адресов веб-серверов, которые вы поставляете. Под типами укажите один адрес IPv4 или IPv6 или подсеть с использованием CIDR. обозначение (например, 192.168.0.0/22). Если вам нужно ввести другую запись, новое поле появится после того, как вы завершите добавление предыдущей записи.
   Приложения для Android	Добавьте имя вашего пакета и отпечаток сертификата подписи SHA-1 , чтобы ограничить использование вашего Android-приложения. Под типами добавьте отпечаток сертификата подписи SHA-1. и имя вашего пакета Android из файла AndroidManifest. xml.
   Приложения для iOS	Принимайте запросы от приложения iOS с указанным вами идентификатором пакета. Под типами выберите соответствующий идентификатор пакета iOS из списка.

4. Нажмите Сохранить .
   Ограничение становится частью ключа API определение после этого шага. Если вы не предоставите соответствующий подробности или не нажимайте «Сохранить», ключ API не будет ограничен. (Для получения дополнительной информации см. Руководство по Получить ключ API . для конкретного API или SDK, которые вас интересуют.)

Чтобы установить ограничение API для ключа API

1. Перейти на панель учетных данных.
2. Выберите ключ API, который вы хотите ограничить.
   Откроется страница Ограничить и переименовать ключ API .
3. Согласно ограничениям API :
   • Щелкните Клавиша ограничения .
   • Щелкните раскрывающийся список Select APIs и выберите API или SDK. вы хотите, чтобы ваше приложение получало доступ с помощью ключа API.(Если API или SDK нет в списке, вам необходимо включить его.)
4. Нажмите Сохранить .
   Ограничение становится частью ключа API определение после этого шага. Если вы не предоставите соответствующий подробности или не нажимайте «Сохранить», ключ API не будет ограничен. (Для получения дополнительной информации см. Руководство по Получить ключ API . для конкретного API или SDK, которые вас интересуют.)

Ключевые ограничения API и передовые методы

В следующих таблицах перечислены соответствующие ограничения ключей API и передовые практики для каждого API платформы Google Maps, SDK или сервис.

Веб-сайты с JavaScript, встроенными или статическими API Карт

Приложения и серверы, использующие веб-службы

Приложения для Android

приложений для iOS

¹ Вы можете использовать неограниченный ключ API с любым API платформы Google Maps или SDK. Однако настоятельно рекомендуется ограничить свой API. ключи, особенно в следующих сценариях:

• Тестовая среда будет общедоступной.
• Приложение, использующее ключ API, готово к использованию в производственной среде.

² Для мобильных приложений рассмотрите возможность использования собственного SDK Карт для Android и SDK Карт для iOS.

³ Для статического API Карт и Статический API просмотра улиц, помимо ключа API, вам необходимо предоставить цифровой подпись , чтобы превысить дневную квоту в 25 000 загрузок карт.

Примечание. Общие секреты, используемые для подписи, требуют как минимум того же уровня безопасности, что и ключи API. используется с API веб-служб Карт.

Кроме того, если вам нужно динамически подписывать запросы изображений, делайте это на стороне сервера. Если ваши приложения полагаются на стороне клиента для генерации статических изображений, защитите их с помощью одного или нескольких следующие техники:

Если вы подписываете свои запросы, также проверьте, сколько неподписанных запросов вы хотите разрешить в день, и соответствующим образом измените квоты неподписанных запросов.

⁴ Ограничения IP могут быть непрактичными, например, в мобильные приложения и облачные среды, использующие динамические IP-адреса. Когда используешь API веб-служб Карт в этих сценариях, защитите свои приложения, используя один или несколько из следующих методов:

⁵ Для мобильных приложений рассмотрите возможность использования собственного SDK Places для Android и SDK Places для iOS.

Создание ключей сервисных аккаунтов и управление ими | Документация Cloud IAM

На этой странице объясняется, как создавать ключи учетной записи службы и управлять ими с помощью Google Cloud Console, инструмент командной строки gcloud , API управления идентификацией и доступом или один клиентских библиотек Google Cloud.

Прежде чем начать

Требуемые разрешения

Чтобы разрешить пользователю управлять ключами учетной записи службы, предоставьте ключ учетной записи службы. Роль администратора ( ролей / iam.serviceAccountKeyAdmin ). Для получения дополнительной информации см. Роли сервисных аккаунтов.

IAM также содержат разрешения на управление сервисом. ключи учетной записи. Вы не должны назначать базовые роли в производственной среде, но вы можете предоставить их в среда разработки или тестирования.

Создание ключей сервисного аккаунта

Для использования учетной записи службы за пределами Google Cloud, например, в других платформы или локально, вы должны сначала установить идентичность службы учетная запись.Пары открытого и закрытого ключей обеспечивают безопасный способ достижения этой цели. Цель. Когда вы создаете ключ учетной записи службы, общедоступная часть сохраняется на Google Cloud, а приватная часть доступна только вам. Для большего информацию о парах открытого и закрытого ключей см. Ключи сервисного аккаунта.

Вы можете создать ключ сервисного аккаунта используя облачную консоль, инструмент gcloud , serviceAccounts.keys.create () метод или одну из клиентских библиотек. У служебного аккаунта может быть до 10 ключей.

В приведенных ниже примерах sa-name — это имя вашего сервисный аккаунт, а id-проекта — это идентификатор вашего Проект Google Cloud. Вы можете получить sa-name @ идентификатор проекта .iam.gserviceaccount.com строка из учетных записей служб страницу в облачной консоли.

Консоль

1. В облачной консоли перейдите на страницу Учетные записи служб .

   Перейти к сервисным счетам

2. Выберите проект.

3. Щелкните адрес электронной почты учетной записи службы, для которой вы хотите создать ключ. для.

4. Щелкните вкладку Keys .

5. Щелкните раскрывающееся меню Добавить ключ , затем выберите Создать новый ключ .

6. Выберите JSON в качестве типа ключа и нажмите Создать .

При нажатии Создать загружается файл ключа учетной записи службы. После загрузки ключевой файл, вы не можете загрузить его снова.

Загруженный ключ имеет следующий формат, где закрытый ключ — это закрытая часть общедоступного / закрытого пара ключей:

{
  "type": "service_account",
  "project_id": " идентификатор проекта ",
  "private_key_id": " идентификатор ключа ",
  "private_key": "----- BEGIN PRIVATE KEY ----- \ n  private-key  \ n ----- END PRIVATE KEY ----- \ n",
  "client_email": " service-account-email ",
  "client_id": " идентификатор клиента ",
  "auth_uri": "https: // account.google.com/o/oauth3/auth ",
  "token_uri": "https://accounts.google.com/o/oauth3/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth3/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/  service-account-email "
}
 

Убедитесь, что файл ключа надежно хранится, поскольку его можно использовать для аутентификации. в качестве учетной записи службы. Вы можете переместить и переименовать этот файл, как вы нравиться.

Вы можете использовать файлы ключей учетной записи службы для аутентификации приложения как сервисный аккаунт.

gcloud

Выполнить ключей сервисных учетных записей gcloud iam создать команда для создания ключей учетной записи службы.

Заменить следующие значения:

• ключевой файл : путь к новому выходному файлу для закрытый ключ — например, ~. / sa-private-key.json .
• sa-name : имя учетной записи службы создать ключ для.
• идентификатор проекта : идентификатор вашего проекта Google Cloud.

Ключи сервисных учетных записей gcloud iam создают файл ключей   \
    --iam-account =  sa-name  @  идентификатор проекта  .iam.gserviceaccount.com
 

Выход:

создан ключ [e44da1202f82f8f4bdd9d92bc412d1d8a837fa83] типа [json] как
[/ usr / home / username /  ключевой файл ] для
[ sa-name  @  id-проекта  .iam.gserviceaccount.com]
 

Теперь файл ключа служебной учетной записи загружен на ваш компьютер. После тебя скачать ключевой файл, вы не можете скачать его повторно.

Загруженный ключ имеет следующий формат, где закрытый ключ — это закрытая часть общедоступного / закрытого пара ключей:

{
  "type": "service_account",
  "project_id": " идентификатор проекта ",
  "private_key_id": " идентификатор ключа ",
  "private_key": "----- BEGIN PRIVATE KEY ----- \ n  private-key  \ n ----- END PRIVATE KEY ----- \ n",
  "client_email": " service-account-email ",
  "client_id": " идентификатор клиента ",
  "auth_uri": "https: // account.google.com/o/oauth3/auth ",
  "token_uri": "https://accounts.google.com/o/oauth3/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth3/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/  service-account-email "
}
 

Убедитесь, что файл ключа надежно хранится, поскольку его можно использовать для аутентификации. в качестве учетной записи службы. Вы можете переместить и переименовать этот файл, как вы нравиться.

Вы можете использовать файлы ключей учетной записи службы для аутентификации приложения как сервисный аккаунт.

ОТДЫХ

В projects.serviceAccounts.keys.create создает ключ для учетной записи службы.

Прежде чем использовать какие-либо данные запроса ниже, сделайте следующие замены:

• PROJECT_ID : Ваш проект Google Cloud Я БЫ. Идентификаторы проекта представляют собой буквенно-цифровые строки, например my-project .
• SA_NAME : имя учетной записи службы, для которой вы хотите создать ключ. для.
• KEY_ALGORITHM : Необязательно. Ключевой алгоритм для использования ключ. Значение по умолчанию, которое может быть изменено, — это 2048-битный ключ RSA. Для списка всех возможных значений см. Ссылка на ServiceAccountKeyAlgorithm .

Метод HTTP и URL:

 POST https://iam.googleapis.com/v1/projects/  PROJECT_ID  / serviceAccounts /  SA_NAME  @  PROJECT_ID  .iam.gserviceaccount.com / keys 

Тело запроса JSON:

{
  "keyAlgorithm": " KEY_ALGORITHM "
}
 

Чтобы отправить запрос, разверните одну из следующих опций:

curl (Linux, macOS или Cloud Shell)

Сохраните тело запроса в файле с именем request.json , и выполните следующую команду:

 curl -X POST \ 
 -H "Авторизация: предъявитель" $ (gcloud auth application-default print-access-token) \ 
 -H "Content-Type: application / json; charset = utf-8" \ 
 -d @ request.json \ 
 https://iam.googleapis.com/v1/projects/  PROJECT_ID  / serviceAccounts /  SA_NAME  @  PROJECT_ID .iam.gserviceaccount.com/keys 

PowerShell (Windows)

Сохраните тело запроса в файле с именем request.json , и выполните следующую команду:

 $ cred = gcloud auth application-default print-access-token 
 $ headers = @ {"Authorization" = "Bearer $ cred"} 
 Invoke-WebRequest `
 -Method POST` 
 -Headers $ headers `
 -ContentType: "application / json; charset = utf-8" `
 -InFile запрос.json `
 -Uri" https://iam.googleapis.com/v1/projects/  PROJECT_ID  / serviceAccounts /  SA_NAME  @  PROJECT_ID  .iam.gserviceaccount.com / keys "| Select-Object -Expand Content 
 

API Explorer (браузер)

Скопируйте тело запроса и откройте справочная страница метода. Панель API Explorer открывается в правой части страницы. Вы можете взаимодействовать с этим инструментом для отправки запросов. Вставьте текст запроса в этот инструмент, заполните все остальные обязательные поля и нажмите Execute .

Ответ содержит ключ для вашей учетной записи службы. Возвращенный ключ имеет следующий формат: где ENCODED_PRIVATE_KEY — это закрытая часть открытого / закрытого ключа пара, закодированная в base64.

{
  "name": "projects /  PROJECT_ID  / serviceAccounts /  SERVICE_ACCOUNT_EMAIL  / keys /  KEY_ID ",
  "privateKeyType": "TYPE_GOOGLE_CREDENTIALS_FILE",
  "privateKeyData": " ENCODED_PRIVATE_KEY ",
  "validAfterTime": " ДАТА ",
  "validBeforeTime": " ДАТА ",
  "keyAlgorithm": "KEY_ALG_RSA_2048"
}
 

Чтобы создать файл ключа, который можно использовать для аутентификации в качестве учетной записи службы, расшифровать данные закрытого ключа и сохранить их в файл:

Linux

Выполните следующую команду:

echo ' ENCODED_PRIVATE_KEY ' | base64 --decode>  ПУТЬ 
 

Замените PATH на путь к нужному файлу. для сохранения ключа.Используйте расширение файла .json .

macOS

Выполните следующую команду:

echo ' ENCODED_PRIVATE_KEY ' | base64 --decode>  ПУТЬ 
 

Замените PATH на путь к нужному файлу. для сохранения ключа. Используйте расширение файла .json .

PowerShell

1. Сохранение закодированных данных закрытого ключа ( ENCODED_PRIVATE_KEY ) в файле.

2. Используйте certutil для декодирования файла:

   certutil -decode  ENCODED_FILE   DECODED_FILE 
    

   Заменить следующие значения:

   • ENCODED_FILE : путь к файлу, содержащему закодированные данные закрытого ключа.
   • DECODED_FILE : путь к файлу, который вы хотите для сохранения ключа. Используйте расширение файла .json .

Обязательно храните ключевые данные в надежном месте, потому что они могут быть используется для аутентификации в качестве вашей учетной записи службы.

Вы можете использовать файлы ключей учетной записи службы для аутентификации приложения как сервисный аккаунт.

C #

Перед тем, как попробовать этот пример, следуйте инструкциям по установке C # в Быстрый запуск IAM с использованием клиентских библиотек. Для получения дополнительной информации см. Справочная документация по IAM C # API.

Перейти

Перед тем, как попробовать этот образец, следуйте инструкциям по настройке Go в Быстрый запуск IAM с использованием клиентских библиотек. Для получения дополнительной информации см. Справочная документация по IAM Go API.

Ява ​​

Перед тем, как попробовать этот пример, следуйте инструкциям по установке Java в Быстрый запуск IAM с использованием клиентских библиотек. Для получения дополнительной информации см. Справочная документация по IAM Java API.

Питон

Перед тем, как попробовать этот пример, следуйте инструкциям по установке Python в Быстрый запуск IAM с использованием клиентских библиотек.Для получения дополнительной информации см. Справочная документация по IAM Python API.

Google гарантирует, что все открытые ключи для всех учетных записей служб являются общедоступными. доступен для всех и доступен для проверки подписей, созданных с помощью закрытый ключ. Открытый ключ общедоступен по следующим URL-адресам:

• x.509: https: //www.googleapis.com / service_accounts / v1 / metadata / x509 / sa-name @ идентификатор проекта .iam.gserviceaccount.com
• Веб-ключ JSON (JWK): https://www.googleapis.com/service_accounts/v1/jwk/ sa-name @ идентификатор проекта .iam.gserviceaccount.com
Конечная точка
• Raw: https://www.googleapis.com/service_accounts/v1/metadata/raw/ sa-name @ идентификатор проекта . iam.gserviceaccount.com

Листинг ключей учетной записи службы

Вы можете перечислить ключи учетной записи службы для учетной записи службы, используя Облачная консоль, инструмент gcloud , serviceAccount.keys.list () метод или одну из клиентских библиотек.

Метод serviceAccount.keys.list () обычно используется для аудита службы. учетные записи и ключи, или для создания настраиваемых инструментов для управления учетными записями служб.

Чтобы узнать, к какому проекту принадлежит ваш ключ, вы можете скачать ключ как JSON-файл и просмотрите этот файл.

Вы можете увидеть в списке ключи, которые вы не создавали. Эти Ключи, управляемые Google Cloud, используемые сервисами Google Cloud, такими как App Engine и Compute Engine.Для получения дополнительной информации о разницу между пользовательскими ключами и ключами, управляемыми Google Cloud, см. Общие сведения об учетных записях служб.

Консоль

1. В облачной консоли перейдите на страницу Учетные записи служб .

   Перейти к сервисным счетам

2. Выберите проект. Облачная консоль перечисляет все сервисные аккаунты и соответствующие им ключи.

gcloud

Выполнить список ключей сервисных учетных записей gcloud iam команда для вывода списка ключей учетной записи службы.

Заменить следующие значения:

• sa-name : имя учетной записи службы перечислить ключи для.
• идентификатор проекта : идентификатор вашего проекта Google Cloud.

Список ключей сервисных аккаунтов gcloud iam \
    --iam-account  sa-name  @  идентификатор проекта  .iam.gserviceaccount.com
 

Выход:

ОТДЫХ

В проектов.serviceAccounts.keys.list Метод перечисляет все ключи учетной записи службы для учетной записи службы.

Прежде чем использовать какие-либо данные запроса ниже, сделайте следующие замены:

• PROJECT_ID : Ваш проект Google Cloud Я БЫ. Идентификаторы проекта представляют собой буквенно-цифровые строки, например my-project .
• SA_NAME : имя учетной записи службы, ключи которой вы хотите перечислить.
• KEY_TYPES : необязательно. Список типов ключей, разделенных запятыми, которые вы хотите включить в ответ. Тип ключа указывает, управляется ли ключ пользователем. ( USER_MANAGED ) или управляемый системой ( SYSTEM_MANAGED ). Если оставить пустым, все ключи возвращены.

Метод HTTP и URL:

 ПОЛУЧИТЬ https://iam.googleapis.com/v1/projects/  PROJECT_ID  / serviceAccounts /  SA_NAME  @  PROJECT_ID .iam.gserviceaccount.com/keys?keyTypes=  KEY_TYPES  

Чтобы отправить запрос, разверните одну из следующих опций:

curl (Linux, macOS или Cloud Shell)

Выполните следующую команду:

 curl -X GET \ 
 -H "Авторизация: предъявитель" $ (gcloud auth application-default print-access-token) \ 
 https: // iam.googleapis.com/v1/projects/  PROJECT_ID  / serviceAccounts /  SA_NAME  @  PROJECT_ID  .iam.gserviceaccount.com / keys? keyTypes =  KEY_TYPES  

PowerShell (Windows)

Выполните следующую команду:

 $ cred = gcloud auth application-default print-access-token 
 $ headers = @ {"Authorization" = "Bearer $ cred"} 
 Invoke-WebRequest `
 -Method GET` 
 -Headers $ headers `
 -Uri" https: // iam. googleapis.com/v1/projects/  PROJECT_ID  / serviceAccounts /  SA_NAME  @  PROJECT_ID  .iam.gserviceaccount.com / keys? keyTypes =  KEY_TYPES  "| Select-Object -Expand Content Explorer 
 

Открой справочная страница метода. Панель API Explorer открывается в правой части страницы. Вы можете взаимодействовать с этим инструментом для отправки запросов. Заполните все обязательные поля и нажмите Выполнить .

Вы должны получить ответ JSON, подобный следующему:

{
  "ключи": [
    {
      "имя": "projects/my-project/serviceAccounts/[email protected]/keys/90c48f61c65cd56224a12ab18e6ee9ca9c3aee7c",
      "validAfterTime": "2020-03-04T17: 39: 47Z",
      "validBeforeTime": "9999-12-31T23: 59: 59Z",
      "keyAlgorithm": "KEY_ALG_RSA_2048",
      "keyOrigin": "GOOGLE_PROVIDED",
      "keyType": "USER_MANAGED"
    },
    {
      "name": "projects / my-project / serviceAccounts / my-service-account @ my-project.iam.gserviceaccount.com/keys/e5e3800831ac1adc8a5849da7d827b4724b1fce8 ",
      "validAfterTime": "2020-03-31T23: 50: 09Z",
      "validBeforeTime": "9999-12-31T23: 59: 59Z",
      "keyAlgorithm": "KEY_ALG_RSA_2048",
      "keyOrigin": "GOOGLE_PROVIDED",
      "keyType": "USER_MANAGED"
    },
    {
      "имя": "projects/my-project/serviceAccounts/[email protected]/keys/b97699f042b8eee6a846f4f96259fbcd13e2682e",
      "validAfterTime": "2020-05-17T18: 58: 13Z",
      "validBeforeTime": "9999-12-31T23: 59: 59Z",
      "keyAlgorithm": "KEY_ALG_RSA_2048",
      "keyOrigin": "GOOGLE_PROVIDED",
      "keyType": "USER_MANAGED"
    }
  ]
}
 

C #

Перед тем, как попробовать этот пример, следуйте инструкциям по установке C # в Быстрый запуск IAM с использованием клиентских библиотек. Для получения дополнительной информации см. Справочная документация по IAM C # API.

Перейти

Перед тем, как попробовать этот образец, следуйте инструкциям по настройке Go в Быстрый запуск IAM с использованием клиентских библиотек. Для получения дополнительной информации см. Справочная документация по IAM Go API.

Java

Перед тем, как попробовать этот пример, следуйте инструкциям по установке Java в Быстрый запуск IAM с использованием клиентских библиотек.Для получения дополнительной информации см. Справочная документация по IAM Java API.

Python

Перед тем, как попробовать этот пример, следуйте инструкциям по установке Python в Быстрый запуск IAM с использованием клиентских библиотек. Для получения дополнительной информации см. Справочная документация по IAM Python API.

Получение ключа сервисного аккаунта

Вы можете получить данные закрытого ключа для ключа учетной записи службы, только если ключ первый создан.

Вы можете получить основную информацию о ключе, такую ​​как его идентификатор, алгоритм и общедоступный ключевые данные с projects.serviceAccounts.keys.get () Метод REST API. Использование облачной консоли или инструмента командной строки gcloud не допускается. поддерживается.

Выгрузка публичных ключей для сервисных аккаунтов

Вы можете загрузить часть открытого ключа управляемая пользователем пара ключей к сервисный аккаунт. После того, как вы загрузите открытый ключ, он постоянно связан с учетной записью службы и будет использоваться так же, как любые другие ключи учетной записи службы, управляемой пользователем.Чтобы отключить возможность загрузки ключей для вашего проекта, см. ограничение загрузки ключа учетной записи службы.

Если вы решили использовать управляемую пользователем пару ключей вместо ключа, управляемого Google пару, убедитесь, что вы обслуживаете ее, и регулярно меняйте ее.

Загружаемый ключ должен быть открытым ключом RSA, заключенным в Сертификат X.509 v3 в кодировке base64. Ты можешь использовать такие инструменты, как OpenSSL, для генерации ключа и сертификат в этом формате. Например, следующая команда генерирует 2048-битная пара ключей RSA и обертывает открытый ключ в самозаверяющем сертификате, который действительно 365 дней:

  openssl req -x509 -nodes -newkey rsa: 2048 -дней 365 \
    -keyout / путь / к / частному_ ключу.pem \
    -out /path/to/public_key.pem \
    -subj "/ CN = не используется"
  

Затем вы можете загрузить файл public_key.pem в качестве открытого ключа для службы. учетная запись.

Консоль

1. В облачной консоли перейдите на страницу Учетные записи служб .

   Перейти к сервисным счетам

2. Выберите проект.

3. Щелкните адрес электронной почты учетной записи службы, в которую вы хотите загрузить ключ. для.

4. Щелкните вкладку Keys .

5. Щелкните раскрывающееся меню Добавить ключ , затем выберите Загрузить существующий ключ .

6. Щелкните Обзор , затем найдите и выберите файл открытого ключа. В качестве альтернативы, вы можете скопировать и вставить содержимое вашего файла открытого ключа в Вставить существующее поле ключа .

7. Нажмите Загрузить .

gcloud

Выполнить загрузка ключей сервисных аккаунтов gcloud iam команда для загрузки открытого ключа для подписи ключей учетной записи службы.

Заменить следующие значения:

• ключевой файл : путь к файлу, содержащему ключевые данные для загрузки — например, ./public_key.pem .
• sa-name : имя учетной записи службы для загрузки ключа.
• идентификатор проекта : идентификатор вашего проекта Google Cloud.

загрузка ключей сервисных аккаунтов gcloud iam  файл ключей  \
    --iam-account  sa-name  @  идентификатор проекта .iam.gserviceaccount.com
 

Вывод содержит уникальный идентификатор загруженного ключа:

Имя: projects /  идентификатор проекта  / serviceAccounts /  sa-name  @  идентификатор проекта  . iam.gserviceaccount.com / keys / c7b74879da78e4cdcbe7e1bf5e129375c0bfa8d0
 

Чтобы определить, была ли команда успешной, выполните команду список ключей сервисных аккаунтов gcloud iam команда:

Список ключей сервисных аккаунтов gcloud iam \
    --iam-account  sa-name  @  идентификатор проекта .iam.gserviceaccount.com
 

Вывод будет содержать тот же уникальный идентификатор, который был возвращен после ключ был создан:

ОТДЫХ

В projects.serviceAccounts.keys.upload загружает открытый ключ из пары ключей, управляемой пользователем, и добавляет этот ключ в учетная запись службы.

Прежде чем использовать какие-либо данные запроса ниже, сделайте следующие замены:

• PROJECT_ID : Ваш проект Google Cloud Я БЫ. Идентификаторы проекта представляют собой буквенно-цифровые строки, например my-project .
• SA_NAME : имя учетной записи службы, с которой будет связан ключ.
• PUBLIC_KEY_DATA : данные открытого ключа для пары ключей.Должен быть RSA открытый ключ, заключенный в сертификат X.509 v3. Закодируйте данные открытого ключа в base64, включая первую строку, ----- BEGIN CERTIFICATE ----- , и последнюю строку, ----- КОНЕЦ СЕРТИФИКАТ ----- .

Метод HTTP и URL:

 POST https://iam.googleapis.com/v1/projects/  PROJECT_ID  / serviceAccounts /  SA_NAME  @  PROJECT_ID  .iam.gserviceaccount.com / keys: upload 

Тело запроса JSON:

{
  "publicKeyData": " PUBLIC_KEY_DATA "
}
 

Чтобы отправить запрос, разверните одну из следующих опций:

curl (Linux, macOS или Cloud Shell)

Сохраните тело запроса в файле с именем request.json , и выполните следующую команду:

 curl -X POST \ 
 -H "Авторизация: предъявитель" $ (gcloud auth application-default print-access-token) \ 
 -H "Content-Type: application / json; charset = utf-8" \ 
 -d @ request.json \ 
 https://iam.googleapis.com/v1/projects/  PROJECT_ID  / serviceAccounts /  SA_NAME  @  PROJECT_ID .iam.gserviceaccount.com/keys:upload 

PowerShell (Windows)

Сохраните тело запроса в файле с именем request.json , и выполните следующую команду:

 $ cred = gcloud auth application-default print-access-token 
 $ headers = @ {"Authorization" = "Bearer $ cred"} 
 Invoke-WebRequest `
 -Method POST` 
 -Headers $ headers `
 -ContentType: "application / json; charset = utf-8" `
 -InFile запрос.json `
 -Uri" https://iam.googleapis.com/v1/projects/  PROJECT_ID  / serviceAccounts /  SA_NAME  @  PROJECT_ID  .iam.gserviceaccount.com / keys: upload "| Select-Object -Expand Content 
 

API Explorer (браузер)

Скопируйте тело запроса и откройте справочная страница метода. Панель API Explorer открывается в правой части страницы. Вы можете взаимодействовать с этим инструментом для отправки запросов. Вставьте текст запроса в этот инструмент, заполните все остальные обязательные поля и нажмите Execute .

Вы должны получить ответ JSON, подобный следующему:

{
  "имя": "projects/my-project/serviceAccounts/[email protected]/keys/c7b74879da78e4cdcbe7e1bf5e129375c0bfa8d0",
  "validAfterTime": "2020-05-17T19: 31: 19Z",
  "validBeforeTime": "2021-05-17T19: 31: 19Z",
  "keyAlgorithm": "KEY_ALG_RSA_2048",
  "keyOrigin": "USER_PROVIDED",
  "keyType": "USER_MANAGED"
}
 

Удаление ключей сервисного аккаунта

Вы можете удалить ключ учетной записи службы с помощью Cloud Console, Инструмент gcloud , serviceAccount.keys.delete () метод или одну из клиентских библиотек.

Если вы удалите ключ, ваше приложение больше не сможет получить доступ Ресурсы Google Cloud, использующие этот ключ. Лучшая практика безопасности — Регулярно меняйте ключи учетной записи службы. Вы можете повернуть ключ, создав новый ключ, обновление приложений для использования нового ключа и удаление старого ключ. Используйте метод serviceAccount.keys.create () и serviceAccount.keys.delete () вместе, чтобы автоматизировать ротацию.

Консоль

1. В облачной консоли перейдите на страницу Учетные записи служб .

   Перейти к сервисным счетам

2. Выберите проект.

3. Щелкните адрес электронной почты учетной записи службы, ключ которой вы хотите удалить.

4. Щелкните вкладку Keys .

5. В списке ключей щелкните Удалить удалить для каждого ключа вы хотите удалить.

gcloud

Выполнить ключей сервисных учетных записей gcloud iam удалить команда для удаления ключей сервисного аккаунта.

Заменить следующие значения:

• идентификатор ключа : идентификатор ключа для удаления.
• sa-name : имя учетной записи службы, для которой используется ключ принадлежит.
• идентификатор проекта : идентификатор вашего проекта Google Cloud.

gcloud iam service-accounts ключи удалить  идентификатор ключа  \
    --iam-account  sa-name  @  идентификатор проекта  .iam.gserviceaccount.com
 

Выход:

Удален ключ [8e6e3936d7024646f8ceb39792006c07f4a9760c] для
учетная запись службы [ sa-name  @  id-проекта .iam.gserviceaccount.com]
 

ОТДЫХ

В projects.serviceAccounts.keys.delete удаляет ключ учетной записи службы.

Прежде чем использовать какие-либо данные запроса ниже, сделайте следующие замены:

• PROJECT_ID : Ваш проект Google Cloud Я БЫ. Идентификаторы проекта представляют собой буквенно-цифровые строки, например my-project .
• SA_NAME : имя учетной записи службы, ключ которой вы хотите удалить.
• KEY_ID : идентификатор ключа, который вы хотите удалить.

Метод HTTP и URL:

 УДАЛИТЬ https://iam.googleapis.com/v1/projects/  PROJECT_ID  / serviceAccounts /  SA_NAME  @  PROJECT_ID  .iam.gserviceaccount.com / keys /  KEY_ID  

Чтобы отправить запрос, разверните одну из следующих опций:

curl (Linux, macOS или Cloud Shell)

Выполните следующую команду:

 curl -X DELETE \ 
 -H "Авторизация: предъявитель" $ (gcloud auth application-default print-access-token) \ 
 https://iam.googleapis.com/v1/projects/  PROJECT_ID  / serviceAccounts /  SA_NAME  @  PROJECT_ID  .iam.gserviceaccount.com / keys /  KEY_ID  

PowerShell (Windows)

Выполните следующую команду:

 $ cred = gcloud auth application-default print-access-token 
 $ headers = @ {"Authorization" = "Bearer $ cred"} 
 Invoke-WebRequest `
 -Method DELETE` 
 -Headers $ headers `
 -Uri" https://iam.googleapis.com/v1/projects/  PROJECT_ID  / serviceAccounts /  SA_NAME  @  PROJECT_ID  .iam.gserviceaccount.com/keys/  KEY_ID  "| Select-Object -Expand Content 
 

API Explorer (браузер)

Открой справочная страница метода. Панель API Explorer открывается в правой части страницы. Вы можете взаимодействовать с этим инструментом для отправки запросов. Заполните все обязательные поля и нажмите Выполнить .

Вы должны получить ответ JSON, подобный следующему:

{
}
 

C #

Перед тем, как попробовать этот пример, следуйте инструкциям по установке C # в Быстрый запуск IAM с использованием клиентских библиотек.Для получения дополнительной информации см. Справочная документация по IAM C # API.

Перейти

Перед тем, как попробовать этот образец, следуйте инструкциям по настройке Go в Быстрый запуск IAM с использованием клиентских библиотек. Для получения дополнительной информации см. Справочная документация по IAM Go API.

Ява

Перед тем, как попробовать этот пример, следуйте инструкциям по установке Java в Быстрый запуск IAM с использованием клиентских библиотек.Для получения дополнительной информации см. Справочная документация по IAM Java API.

Питон

Перед тем, как попробовать этот пример, следуйте инструкциям по установке Python в Быстрый запуск IAM с использованием клиентских библиотек. Для получения дополнительной информации см. Справочная документация по IAM Python API.

Попробуйте сами

Если вы новичок в Google Cloud, создайте учетную запись, чтобы оценить, насколько продукты работают в реальных сценариях.Новые клиенты также получают 300 долларов США в бесплатные кредиты для запуска, тестирования и развертывания рабочих нагрузок.

ключей API

Stripe аутентифицирует ваши запросы API с помощью ключей API вашего аккаунта.Если вы не укажете свой ключ при запросе API или используете неверный или устаревший, Stripe вернет ошибку.

Каждой учетной записи предоставляются отдельные ключи для тестирования и выполнения транзакций в реальном времени. Все запросы API существуют либо в тестовом, либо в реальном режиме, и объекты — клиенты, планы, купоны и т. Д. — в одном режиме не могут управляться объектами в другом.

Также существует два типа ключей API: для публикации и секретный .

• Публикуемые ключи API предназначены исключительно для идентификации вашей учетной записи с помощью Stripe, они не являются секретными.Другими словами, их можно безопасно публиковать в таких местах, как ваш JavaScript-код Stripe.js, или в приложении для Android или iPhone.
• Секретные ключи API должны храниться в секрете и храниться только на ваших серверах. Секретный ключ API вашей учетной записи может выполнять любой запрос API к Stripe без ограничений.

Каждая учетная запись имеет в общей сложности четыре ключа: пара ключей для публикации и секретного ключа для тестового режима и режима реального времени.

Получение ключей API

Ключи API всегда доступны на панели инструментов.Для вашего удобства test API-ключи для вашей учетной записи:

Stripe автоматически заполняет примеры кода в нашей документации вашими тестовыми ключами API, пока вы вошли в систему — только вы можете видеть эти значения.

Используйте только свои тестовые ключи API для тестирования и разработки . Это гарантирует, что вы случайно не измените текущих клиентов или платежи.

Если у вас нет роли администратора или разработчика, у вас может не быть доступа для просмотра ключей API на панели инструментов. Свяжитесь с владельцем вашей учетной записи Stripe и попросите, чтобы его добавили в его команду в качестве разработчика.

Тестовый и живой режимы

Тестовый и живой режимы работают практически одинаково, с некоторыми необходимыми отличиями:

• В тестовом режиме платежи не обрабатываются сетями карт или поставщиками платежей, и может использоваться только наша тестовая информация .
• Некоторые способы оплаты, использующие Источники, имеют более детализированный поток в режиме реального времени, с большим количеством шагов, требуемых, чем в тестовом режиме.
• Споры также имеют более детализированный поток в режиме реального времени и более простой процесс тестирования.
• Webhooks, которые не были успешно подтверждены, повторяются три раза в течение нескольких часов (в отличие от 72 часов в режиме реального времени).
• Если вы используете ключи тестового режима для получения учетной записи Connect, созданной в интерактивном режиме, он возвращает объект Account без конфиденциальных полей.Однако вы по-прежнему можете получать доступ и обновлять эти конфиденциальные поля для учетных записей, созданных в тестовом режиме.

Вы можете просмотреть тестовые данные, переключив опцию Просмотр тестовых данных на приборной панели.

Хранение ключей в безопасности

Ваш секретный ключ API может использоваться для выполнения любых вызовов API от имени вашей учетной записи, таких как создание списаний или выполнение возмещения. Обращайтесь со своим секретным ключом API, как с любым другим паролем. Предоставляйте доступ только тем, кому это нужно. Убедитесь, что он не попадает в какую-либо систему контроля версий, которую вы можете использовать.Управляйте доступом к вашему ключу с помощью диспетчера паролей или службы управления секретами.

В режиме реального времени новые секретные ключи видны только при первом доступе к ним. После этого Dashboard редактирует ключ API. Когда ключ раскрыт, вы можете оставить на панели инструментов заметку с описанием того места в вашей системе, куда вы его скопировали. Если вы потеряете свой секретный ключ, вы не сможете восстановить его из Личного кабинета, и вам придется использовать новый ключ или создать новый.

Отображение примечания к отредактированному секретному ключу.

Ключи, созданные до введения этой функции, не скрываются автоматически при открытии, но могут быть скрыты вручную.

Скользящие ключи

Если ключ API скомпрометирован, сверните ключ на панели инструментов, чтобы заблокировать его и сгенерировать новый.

Прокрутка ключа API.

При смене ключа API вы можете сразу заблокировать старый ключ или позволить ему работать в течение 12 часов, что даст вам время для перехода. В любом случае новый ключ можно использовать немедленно.

Ограничение доступа с помощью ограниченных ключей API

Секретные ключи API вашей учетной записи могут использоваться для выполнения любого запроса API без ограничений. Для большей безопасности вы можете создавать ограниченные ключи API, которые ограничивают доступ и разрешения для различных областей данных вашей учетной записи. Они заменяют ваш секретный ключ API и должны использоваться, если вы работаете с микросервисами, которые взаимодействуют с Stripe API от вашего имени.

Ограниченный ключ обеспечивает только минимальный уровень доступа, необходимый службе, при этом защищая данные учетной записи, в которых она не нуждается.Например, вы можете создать ограниченный ключ, который предоставляет доступ только для чтения к данным спора, а затем использовать его со службой мониторинга споров.

Если вам больше не нужен ограниченный ключ (или вы подозреваете, что он был взломан), вы можете отозвать его в любое время. Вы также можете отредактировать ключ, чтобы изменить его уровень доступа.

Ключи с ограниченным доступом предназначены для снижения риска при использовании или создании микросервисов. Их нельзя использовать в качестве альтернативы ключам API вашей учетной записи во время разработки интеграции Stripe — ключи с ограниченным доступом не могут взаимодействовать со многими частями API Stripe.Используйте свои тестовые ключи API во время разработки и живые ключи API, когда ваша интеграция будет запущена.

Супер ключ в СУБД

Автор: Чайтанья Сингх | Сохранено в: СУБД

Определение супер ключа в СУБД : Супер ключ — это набор из одного или нескольких атрибутов (столбцов), которые могут однозначно идентифицировать строку в таблице. Часто новички в СУБД путаются между супер-ключом и кандидатным ключом, поэтому в этой статье мы также обсудим кандидатный ключ и его связь с супер-ключом.

Чем ключ-кандидат отличается от суперключа?

Ответ прост — ключи-кандидаты выбираются из набора супер-ключей, единственное, о чем мы заботимся при выборе ключа-кандидата: он не должен иметь никаких избыточных атрибутов.По этой причине их также называют минимальным супер-ключом.

Давайте рассмотрим пример, чтобы понять это:
Таблица: Сотрудник

 Emp_SSN Emp_Number Emp_Name
--------- ---------- --------
123456789 226 Стив
999999321 227 Аджит
888997212 228 Чайтанья
777778888 229 Роберт
 

Супер ключи : В приведенной выше таблице есть следующие супер ключи. Все следующие наборы суперключей могут однозначно идентифицировать строку таблицы сотрудников.

• {Emp_SSN}
• {Emp_Number}
• {Emp_SSN, Emp_Number}
• {Emp_SSN, Emp_Name}
• {Emp_SSN, Emp_Number, Emp_Name}
• {Emp_Number, Emp_Name}

Ключи-кандидаты : Как я упоминал в начале, ключ-кандидат — это минимальный суперключ без избыточных атрибутов. Следующие два набора суперключей выбираются из вышеперечисленных наборов, поскольку в этих наборах нет избыточных атрибутов.

Только эти два набора являются ключами-кандидатами, поскольку все другие наборы имеют избыточные атрибуты, которые не являются необходимыми для уникальной идентификации.

Супер ключ против ключа кандидата

Я получаю много комментариев относительно путаницы между супер-ключом и кандидатным ключом. Позвольте дать вам четкое объяснение.
1. Сначала вы должны понять, что все ключи-кандидаты являются супер-ключами. Это потому, что ключи-кандидаты выбираются из суперключей.
2. Как мы выбираем ключи-кандидаты из набора супер ключей? Ищем те ключи, из которых нельзя удалить никакие поля. В приведенном выше примере мы не выбрали {Emp_SSN, Emp_Name} в качестве ключа-кандидата, потому что только {Emp_SSN} может идентифицировать уникальную строку в таблице, а Emp_Name является избыточным.

Первичный ключ :
Первичный ключ выбирается из набора ключей-кандидатов. Это делает администратор базы данных или дизайнер базы данных. Можно сказать, что в качестве первичного ключа для таблицы Employee можно выбрать {Emp_SSN} или {Emp_Number} .

Что такое тональность в музыке?

При воспроизведении или прослушивании музыки вы можете услышать, как кто-то говорит, что песня находится в определенной тональности , например «Это в тональности соль мажор». Но что конкретно это означает? И как тональность соотносится с нотами, гаммами и аккордами?

Этот пост определит, что такое тональность в музыке, и как мы можем понять это, глядя на написанное музыкальное произведение.

Что такое ключ?

В музыке тональность — это основная группа высот или нот, образующих гармоническую основу музыкального произведения.

Основные высоты тона, используемые в песне, обычно все из одной конкретной гаммы, и именно отсюда мы называем тональность песни.

Например, если в песне используются только ноты гаммы до мажор, вполне вероятно, что песня находится «в тональности до мажор».

Это будет означать отсутствие острых предметов или плоскостей — C, D, E, F, G, A, B, C.

Однако гамма ля минор также не содержит диезов или бемолей, поэтому, если мы читаем музыкальное произведение без обозначенных диезов или бемолей, оно также может быть в тональности ля минор.

Как отработать тональность песни

Всегда есть два ключа, которые имеют одну и ту же подпись ключа .

Ключевая подпись — это то, что вы видите в начале музыкального произведения сразу после знака ключа.

И прямо перед размером.

Вот подпись с пятью точками (#), которая обычно используется для си-мажор.

Обратите внимание на то, как пять диез находятся прямо между ключом и размером.

Однако эта подпись ключа может также использоваться для обозначения ключа G # minor.

Для каждой подписи ключа всегда есть старший и второстепенный ключ.

Они называются относительными тональностями, и они всегда находятся на расстоянии трех полутонов друг от друга (второстепенная тональность находится на три полутона ниже относительной основной тональности).

Итак, как мы узнаем, является ли тональность мажорной или минорной?

Обычно песня или отрывок начинается и заканчивается тоническим аккордом , который соответствует тональности песни.

Нота, на которой основан тонический аккорд (например, аккорд ре мажор основан на ноте D), просто называется тоникой .

Тонический аккорд также считается домашним аккордом, и песня обычно кажется наиболее нормальной, когда играет этот аккорд или нота.

Итак, чтобы понять, в какой тональности находится пьеса, ищем тонический аккорд и ноту.

В этом примере в тональности написано B Maj / G # min, а мелодия начинается и заканчивается на B, поэтому мы можем предположить, что пьеса находится «в тональности B Maj».

Если он начинается и / или заканчивается на G #, то это будет G # минор, как в следующем примере:

В качестве реальных примеров можно привести две фортепианные сонаты Гайдна.

У них одна и та же тональность — одна диез, но одна — в мажорной тональности, а другая — в минорной.

Это соль мажор, и вы можете заметить ее с самого начала, потому что она начинается (после звукоснимателя) с ноты G в начале первого полного такта.