Установка пакета SDK для Visual Studio Install the Visual Studio SDK

Пакет SDK для Visual Studio (пакет средств разработки программного обеспечения) — дополнительный компонент программы установки Visual Studio. The Visual Studio SDK (Software Development Kit) is an optional feature in Visual Studio setup. Пакет SDK для VS можно установить и позже. You can also install the VS SDK later on.

Установка пакета SDK для Visual Studio при установке Visual Studio Install the Visual Studio SDK as part of a Visual Studio installation

Чтобы включить пакет SDK для VS в установку Visual Studio, установите рабочую нагрузку Разработка расширения Visual Studio в разделе Другие наборы инструментов. To include the VS SDK in your Visual Studio installation, install the Visual Studio extension development workload under Other Toolsets. Эта рабочая нагрузка установит пакет SDK для Visual Studio и необходимые компоненты. This workload will install the Visual Studio SDK and the necessary prerequisites. Дальнейшую настройку установки можно выполнить, выбрав или отменив выбор компонентов в представлении Сводка . You can further tune the installation by selecting or unselecting components from the Summary view.

Установка пакета SDK для Visual Studio после установки Visual Studio Install the Visual Studio SDK after installing Visual Studio

Чтобы установить пакет SDK для Visual Studio после завершения установки Visual Studio, снова запустите установщик Visual Studio и выберите рабочую нагрузку Разработка расширения Visual Studio. To install the Visual Studio SDK after completing your Visual Studio installation, rerun the Visual Studio installer and select the Visual Studio extension development workload.

Установка пакета SDK для Visual Studio из решения Install the Visual Studio SDK from a solution

Если вы открываете решение с проектом расширяемости без предварительной установки пакета SDK для VS, в диалоговом окне Установка отсутствующей функции вам будет предложено установить рабочую нагрузку Разработка расширения Visual Studio: If you open a solution with an extensibility project without first installing the VS SDK, you will be prompted by an Install Missing Feature dialog to install the Visual Studio extension development workload:

Установка и настройка пакета SDK для Microsoft Information Protection (MIP) Microsoft Information Protection (MIP) SDK setup and configuration

В кратком руководстве по началу работы и в подробном руководстве описано создание приложений на основе библиотек SDK и API Microsoft Information Protection. The Quickstart and Tutorial articles are centered around building applications that use the MIP SDK libraries and APIs. В этой статье показано, как установить и настроить подписку Microsoft 365 и рабочую станцию клиента, чтобы подготовить их к использованию пакета SDK. This article shows you how to set up and configure your Microsoft 365 subscription and client workstation, in preparation for using the SDK.

Предварительные условия Prerequisites

Перед началом работы обязательно ознакомьтесь со следующими разделами: Be sure to review the following topics before getting started:

Чтобы соблюдать конфиденциальность пользователей, вам необходимо запрашивать у пользователя разрешение на включение автоматического ведения журнала. To honor user privacy, you must ask the user to consent before enabling automatic logging. Ниже приведено стандартное сообщение, используемое корпорацией Майкрософт для уведомления о ведении журнала. The following example is a standard message Microsoft uses for logging notification:

Включая ведение журнала ошибок и производительности, вы соглашаетесь на отправку данных о производительности и ошибках в корпорацию Майкрософт. Корпорация Майкрософт собирает данные об ошибках и производительности («Данные») через Интернет. Корпорация Майкрософт использует эти Данные для обеспечения и повышения качества, безопасности и целостности продуктов и служб корпорации Майкрософт. Например, мы осуществляем анализ производительности и надежности, включая определение компонентов, которые вы используете, скорость ответа компонентов, производительность устройства, взаимодействие пользователя с интерфейсом и любые проблемы, возникающие с продуктом. Данные также будет включать сведения о конфигурации программного обеспечения (например, сведения об используемых в данный момент программах) и IP-адресе. By turning on Error and Performance Logging, you are agreeing to send Error and Performance Data to Microsoft. Microsoft will collect error and performance data over the internet (“Data”). Microsoft uses this Data to provide and improve the quality, security and integrity of Microsoft products and services. For example, we analyze performance and reliability, such as what features you use, how quickly the features respond, device performance, user interface interactions, and any problems you experience with the product. Data will also include information about the configuration of your software like the software you are currently running, and the IP address.

Регистрация для получения подписки Office 365 Sign up for an Office 365 subscription

Для использования многих пакетов SDK требуется доступ к подписке Office 365. Many of the SDK samples require access to an Office 365 subscription. Если у вас еще нет подписки Office 365, зарегистрируйтесь для получения одного из следующих типов подписки: If you haven’t already, be sure to sign up for one of the following subscription types:

Имя Name	Регистрация Sign-up
Пробная версия Office 365 корпоративный E3 (30-дневная бесплатная пробная версия) Office 365 Enterprise E3 Trial (30-day free trial)	https://go.microsoft.com/fwlink/p/?LinkID=403802
Office 365 корпоративный E3 или E5 Office 365 Enterprise E3 or E5	https://products.office.com/business/office-365-enterprise-e3-business-software
Enterprise Mobility и Security E3 или E5 Enterprise Mobility and Security E3 or E5	https://www.microsoft.com/cloud-platform/enterprise-mobility-security
Azure Information Protection Premium P1 или P2 Azure Information Protection Premium P1 or P2	https://azure.microsoft.com/pricing/details/information-protection/
Microsoft 365 E3, E5 или F1 Microsoft 365 E3, E5, or F1	https://www.microsoft.com/microsoft-365/compare-all-microsoft-365-plans

Настройка меток конфиденциальности Configure sensitivity labels

Если вы используете Azure Information Protection, необходимо перенести метки в Центр безопасности и соответствия требованиям Office 365. If you’re currently using Azure Information Protection, you must migrate your labels to Office 365 Security and Compliance Center. Дополнительные сведения см. в разделе Перемещение меток Azure Information Protection в Центр безопасности и соответствия требованиям Office 365. For more information on the process, see How to migrate Azure Information Protection labels to the Office 365 Security & Compliance Center.

Настройка рабочей станции клиента Configure your client workstation

Затем выполните следующие действия, чтобы убедиться, что клиентский компьютер настроен правильно. Next, complete the following steps to ensure your client computer is set up and configured correctly.

Если вы используете рабочую станцию Windows 10: If you’re using a Windows 10 workstation:

С помощью Центра обновления Windows установите Windows 10 Fall Creators Update версии 1709 или более поздней версии. Using Windows Update, update your machine to Windows 10 Fall Creators Update (version 1709) or later. Чтобы проверить текущую версию, сделайте следующее: To verify your current version:

• Щелкните значок Windows в нижнем левом углу. Click the Windows icon in the lower left.
• Введите «О моем компьютере» и нажмите клавишу ВВОД. Type «About your PC» and press the «Enter» key.
• Прокрутите содержимое окна вниз до раздела Спецификации Windows и найдите поле Версия. Scroll down to Windows specifications and look under Version.

Убедитесь, что на вашей рабочей станции включен «режим разработчика»: Ensure «Developer Mode» is enabled on your workstation:

• Щелкните значок Windows в нижнем левом углу. Click the Windows icon in the lower left.
• Введите «Использовать возможности для разработчиков» и нажмите клавишу ВВОД, когда появится элемент Использовать возможности для разработчиков. Type «Use developer features» and press the «Enter» key, when you see the Use Developer Features item show.
• В диалоговом окне Параметры на вкладке Для разработчиков в разделе «Использовать возможности для разработчиков» установите параметр Режим для разработчиков. On the Settings dialog, For developers tab, under «Use developer features», select the Developer mode option.
• Закройте диалоговое окно Параметры. Close the Settings dialog.

Установите Visual Studio 2017 со следующими рабочими нагрузками и дополнительными компонентами: Install Visual Studio 2017, with the following workloads and optional components:

Рабочая нагрузка Windows Разработка приложений для универсальной платформы Windows, а также следующие дополнительные компоненты: Universal Windows Platform development Windows workload, plus the following optional components:

• Средства универсальной платформы Windows C++C++ Universal Windows Platform tools
• Пакет SDK для Windows 10 SDK 10.0.16299.0 или более поздней версии, если он не включен по умолчанию Windows 10 SDK 10.0.16299.0 SDK or later, if not included by default

Рабочая нагрузка Windows Разработка классических приложений C++ , а также следующие дополнительные компоненты: Desktop development with C++ Windows workload, plus the following optional components:

• Пакет SDK для Windows 10 SDK 10.0.16299.0 или более поздней версии, если он не включен по умолчанию Windows 10 SDK 10.0.16299.0 SDK or later, if not included by default

Так как для установки модулей требуются права администратора, перед установкой необходимо выполнить одно из следующих действий: Because administrator rights are required to install modules, first you need to either:

• войдите на компьютер с учетной записью с правами администратора; sign in to your computer with an account that has Administrator rights.
• запустите Windows PowerShell с повышенными правами пользователя (от имени администратора). run the Windows PowerShell session with elevated rights (Run as Administrator).

Затем запустите командлет install-module -name adal.ps : Then run the install-module -name adal.ps cmdlet:

Скачайте файлы пакета SDK: Download SDK files:

Пакет SDK для MIP поддерживается на следующих платформах (для каждой поддерживаемой платформы и языка предоставляются отдельные скачиваемые файлы): The MIP SDK is supported on the following platforms, with separate downloads for each supported platform/language:

Операционная система Operating system	Версии Versions	Загрузки Downloads	Примечания Notes
Ubuntu Ubuntu	16.04 16.04	TAR.GZ C++ C++ tar.gz
Ubuntu Ubuntu	18,04 18.04	TAR.GZ C++ C++ tar.gz Java (предварительная версия) tar.gz Java (Preview) tar.gz .NET Core NuGet (предварительная версия) .NET Core NuGet (Preview)
RedHat Enterprise Linux RedHat Enterprise Linux	7 с devtoolset-7 7 with devtoolset-7	TAR.GZ C++ C++ tar.gz
Debian Debian	9 9	TAR.GZ C++ C++ tar.gz
MacOS macOS	High Sierra и более поздней версии High Sierra and later	ZIP C++ C++ .zip	Для разработки с помощью Xcode требуется версия 9.4.1 или более поздняя. Xcode development requires 9.4.1 or greater.
Windows Windows	Все поддерживаемые версии, 32- и 64-разрядные All supported versions, 32/64 bit	C++/.NET Framework 4.6.zip C++/.NET Framework 4.6 .zip NuGet C++/.NET C++/.NET NuGet Java (предварительная версия) .zip Java (Preview) .zip
Android Android	7.0 и более поздние версии 7.0 and later	ZIP C++ C++ .zip	Только интерфейсы API защиты и политики. Protection and Policy APIs only.
iOS iOS	Все поддерживаемые версии All supported versions	ZIP C++ C++ .zip	Только интерфейсы API защиты и политики. Protection and Policy APIs only.

Скачиваемые файлы TAR.GZ и ZIP Tar.gz/.Zip downloads

• Bins: скомпилированные двоичные файлы для каждой архитектуры платформы, если применимо. Bins: Compiled binaries for each platform architecture, where applicable.
• Include: файлы заголовков (C++). Include: Header files (C++).
• Samples: исходный код примеров приложений. Samples: Source code for sample applications.

Пакеты NuGet NuGet packages

При разработке в Visual Studio пакет SDK также можно установить с помощью консоли диспетчера пакетов NuGet: If you’re doing Visual Studio development, the SDK can be also installed via the NuGet Package Manager Console:

Если вы не используете пакет NuGet, добавьте пути к двоичным файлам пакета SDK в переменную среды PATH. If you’re not using the NuGet package, add the paths of the SDK binaries to the PATH environment variable. Благодаря переменной PATH клиентские приложения могут находить зависимые двоичные файлы (библиотеки DLL) во время выполнения (необязательно): The PATH variable allows the dependent binaries (DLLs) to be found at runtime, by client applications (OPTIONAL):

Если вы используете рабочую станцию Windows 10: If you’re using a Windows 10 workstation:

Щелкните значок Windows в нижнем левом углу. Click the Windows icon in the lower left.

Введите «Путь» и нажмите клавишу ВВОД, когда появится элемент Изменить переменные среды. Type «Path» and press the «Enter» key, when you see the Edit the system environment variables item show.

В диалоговом окне Свойства системы щелкните Переменные среды. On the System Properties dialog, click Environment Variables.

В диалоговом окне Переменные среды щелкните строку переменной Путь в разделе Пользовательские переменные для , затем выберите Изменить. . On the Environment Variables dialog, click the Path variable row under User variables for , then click Edit. .

В диалоговом окне Изменение переменной среды нажмите кнопку Создать. Будет создана новая редактируемая строка. On the Edit environment variable dialog, click New, which creates a new editable row. Используя полный путь к каждым из подкаталогов file\bins\debug\amd64 , protection\bins\debug\amd64 и upe\bins\debug\amd64 , добавьте новую строку для каждого из них. Using the full path to each of the file\bins\debug\amd64 , protection\bins\debug\amd64 , and upe\bins\debug\amd64 subdirectories, add a new row for each. Каталоги пакета SDK хранятся в формате \bins\ \

, где: The SDK directories are stored in a \bins\ \

= amd64 (x64), x86 и т. д.

= amd64 (x64), x86 , etc.

Обновив переменную Пути, нажмите кнопку OK. When finished updating the Path variable, click OK. Вернувшись в диалоговое окно Переменные среды, еще раз нажмите кнопку OK. Then click OK when returned to the Environment Variables dialog.

Скачайте примеры пакета SDK из GitHub (необязательно): Download SDK samples from GitHub (OPTIONAL):

• Создайте профиль GitHub, если у вас его еще нет. If you don’t have one already, first create a GitHub profile.
• Затем установите последнюю версию клиентских инструментов Git от Software Freedom Conservancy (Git Bash) Then install the latest version of Software Freedom Conservancy’s Git client tools (Git Bash)
• С помощью Git Bash скачайте интересующие вас примеры: Using Git Bash, download the sample(s) of interest:
  • Для просмотра репозиториев используйте следующий запрос: https://github.com/Azure-Samples?utf8=%E2%9C%93&q=MipSdk. Use the following query to view the repositories: https://github.com/Azure-Samples?utf8=%E2%9C%93&q=MipSdk.
  • Выполните команду git clone https://github.com/azure-samples/ в Git Bash, чтобы скачать каждый репозиторий с примером. Using Git Bash, use git clone https://github.com/azure-samples/ to download each sample repository.

Регистрация клиентского приложения в Azure Active Directory Register a client application with Azure Active Directory

В рамках подготовки подписки Microsoft 365 создается соответствующий клиент Azure Active Directory (Azure AD). As part of the Microsoft 365 subscription provisioning process, an associated Azure Active Directory (Azure AD) tenant is created. Клиент Azure AD обеспечивает управление удостоверениями и доступом для учетных записей пользователей и учетных записей приложений Microsoft 365. The Azure AD tenant provides identity and access management for Microsoft 365 user accounts and application accounts. Приложения, которым необходим доступ к защищенным API (таким как API MIP), требуется учетная запись приложения. Applications that require access to secured APIs (such as MIP APIs), require an application account.

Для проверки подлинности и авторизации во время выполнения учетные записи представляются в виде субъектов безопасности, которые являются производными от удостоверения учетных записей. For authentication and authorization at runtime, accounts are represented by a security principal, which is derived from the account’s identity information. Субъекты безопасности, представляющие учетные записи приложений, называются субъектами-службами. Security principals that represent an application account are referred to as a service principal.

Чтобы зарегистрировать учетную запись приложения в Azure AD для использования с примерами и руководствами пакета SDK для MIP: To register an application account in Azure AD for use with the Quickstarts and MIP SDK samples:

Чтобы получить доступ к управлению клиентом Azure AD для создания учетной записи, потребуется выполнить вход на портал Azure с учетной записью пользователя, который является членом роли «Владелец» в подписке. To access Azure AD tenant management for account creation, you’ll need to sign in to the Azure portal with a user account that is a member of the «Owner» role on the subscription. В зависимости от конфигурации клиента для регистрации приложения вы также должны быть членом роли каталога «Глобальный администратор». Depending on the configuration of your tenant, you may also need to be a member of the «Global Admininstrator» directory role to register an application. Мы рекомендуем проводить тестирование с ограниченной учетной записью. We recommend testing with a restricted account. Убедитесь, что у учетной записи есть только права на доступ к необходимым конечным точкам SCC. Be sure the account only has rights to access the necessary SCC endpoints. Пароли в виде открытого текста, указываемые в командной строке, могут быть собраны системами ведения журнала. Cleartext passwords passed via commandline may be collected by logging systems.

Следуйте инструкциям в разделе Регистрация нового приложения статьи «Регистрация приложения в Azure AD». Follow the steps in Register an app with Azure AD, Register a new application section. Для тестирования используйте следующие значения для указанных свойств при выполнении инструкций руководства: For testing purposes, use the following values for the given properties as you go through the guide steps:

• Поддерживаемые типы учетных записей — выберите «Учетные записи в любом каталоге организации». Supported Account Types — Select «Accounts in this organizational directory only.»
• URI перенаправления — выберите для типа URI перенаправления значение «Общедоступный клиент (мобильные и классические)». Redirect URI — Set the redirect URI type to «Public client (mobile & desktop).» Если приложение использует библиотеку проверки подлинности Майкрософт (MSAL), используйте http://localhost . If your application is using the Microsoft Authentication Library (MSAL), use http://localhost . В противном случае используйте что-либо в формате ://authorize . Otherwise, use something in the format ://authorize .

По завершении вы вернетесь на страницу Зарегистрированное приложение для нового приложения. When finished, you’ll be returned to the Registered app page for your new application registration. Скопируйте и сохраните GUID, указанный в поле Идентификатор приложения (клиента) , так как он понадобится при работе с краткими руководствами. Copy and save the GUID in the Application (client) ID field, as you will need it for the Quickstarts.

Затем нажмите кнопку Разрешения API, чтобы добавить API и разрешения, к которым потребуется доступ клиенту. Then click API permissions to add the APIs and permissions to which the client will need access. Щелкните Добавить разрешение, чтобы открыть колонку «Запрос разрешений API». Click Add a permission to open the «Request API permissions» blade.

Теперь добавим API-интерфейсы и разрешения MIP, которые потребуются приложению во время выполнения: Now you’ll add the MIP APIs and permissions the application will require at runtime:

• На странице Выбор API щелкните Служба Rights Management. On the Select an API page, click Azure Rights Management Services.
• На странице API Служба Rights Management Azure щелкните Делегированные разрешения. On the Azure Rights Management Services API page, click Delegated permissions.
• В разделе Выбор разрешений проверьте разрешение user_impersonation. On the Select permissions section, check the user_impersonation permission. Так приложение сможет создать защищенное содержимое и получить к нему доступ от имени пользователя. This right allows the application to create and access protected content on behalf of a user.
• Щелкните Добавить разрешения, чтобы сохранить изменения. Click Add permissions to save.

Повторите шаг 4, но на этот раз, когда дойдете до страницы Выбор API, вам потребуется найти интерфейса API. Repeat step #4, but this time when you get to the Select an API page, you’ll need to search for the API.

• На странице Выбор API щелкните Интерфейсы API, используемые моей организацией, введите в поле поиска Служба синхронизации Microsoft Information Protection и выберите этот API. On the Select an API page, click APIs my organization uses then in the search box type «Microsoft Information Protection Sync Service«, and select it.
• На странице API Microsoft Azure Information Protection щелкните Делегированные разрешения. On the Microsoft Information Protection Sync Service API page, click Delegated permissions.
• Разверните узел UnifiedPolicy и установите флажок UnifiedPolicy.User.Read. Expand the UnifiedPolicy node and check UnifiedPolicy.User.Read
• Щелкните Добавить разрешения, чтобы сохранить изменения. Click Add permissions to save.

Когда вы вернетесь на страницу Разрешения API, щелкните Предоставить согласие администратора для (имя клиента) , а затем щелкните Да. When you’re back on the API permissions page, click Grant admin consent for (Tenant Name), then Yes. Этот шаг предоставляет предварительное разрешение на доступ к API с указанными разрешениями для приложения. This step gives pre-consent to the application using this registration, to access the APIs under the specified permissions. Если вы вошли в систему как глобальный администратор, согласие записывается для всех пользователей в клиенте, которые запускают приложение, в противном случае он применяется только к вашей учетной записи. If you signed in as a global administrator, consent is recorded for all users in the tenant that run the application; otherwise, it applies only to your user account.

По завершении регистрация приложения и разрешения API должны выглядеть так, как показано в этом примере: When finished, application registration and API permissions should look similar to the following examples:

Дополнительные сведения о добавлении интерфейсов API и разрешений в регистрацию см. в разделе Настройка клиентского приложения для доступа к веб-API. For more information on adding APIs and permissions to a registration, see Configure a client application to access web APIs. Здесь вы найдете сведения о добавлении интерфейсов API и разрешений, требуемых клиентскому приложению. Here you’ll find information on adding the APIs and permissions needed by a client application.

Запрос соглашения об интеграции Information Protection (IPIA) Request an Information Protection Integration Agreement (IPIA)

Прежде чем выпускать приложение с поддержкой MIP, необходимо подать заявку на формальное соглашение с корпорацией Майкрософт, а затем заключить это соглашение. Before you can release an application developed with MIP, you must apply for and complete a formal agreement with Microsoft.

Получите соглашение IPIA, отправив на адрес IPIA@microsoft.com сообщение электронной почты со следующими сведениями. Obtain your IPIA by sending an email to IPIA@microsoft.com with the following information:

Тема. Запрос IPIA для название компании Subject: Requesting IPIA for Company Name

В теле сообщения электронной почты укажите следующую информацию: In the body of the email, include:

• название продукта и приложения; Application and product name
• имя и фамилия автора запроса; First and last name of the requester
• адрес электронной почты автора запроса. Email address of the requester

Получив запрос IPIA, мы отправим вам форму (документ Word). Upon receipt of your IPIA request, we’ll send you a form (as a Word document). Изучите условия IPIA и отправьте на адрес IPIA@microsoft.com форму со следующими сведениями: Review the terms and conditions of the IPIA, and return the form to IPIA@microsoft.com with the following information:

• юридическое название компании; Legal name of the Company
• штат/провинция (США и Канада) или страна регистрации; State/Province (US/Canada) or Country of Incorporation
• URL-адрес компании; Company URL
• адрес электронной почты контактного лица; Email address of the contact person
• дополнительные адреса компании (необязательно); Additional addresses of the company (optional)
• название приложения компании; Name of the Company Application
• краткое описание приложения; Brief Description of the Application
• идентификатор клиента; Azure Tenant ID
• идентификатор приложения; App ID for the application
• контактные лица компании, электронная почта и телефон для связи в критической ситуации. Company contacts, email, and phone for Critical Situation Correspondence

Когда мы получим вашу форму, мы отправим вам ссылку с окончательной версией IPIA для цифровой подписи. When we receive your form, we’ll send you the final IPIA link to digitally sign. После того как вы подпишите соглашение, его подпишет соответствующий представитель корпорации Майкрософт, после этого соглашение будет заключено. After your signing, it will be signed by the appropriate Microsoft representative, completing the agreement.

Вы уже подписали IPIA? Already have a signed IPIA?

Если вы уже подписали IPIA и хотите добавить новый идентификатор приложения для приложения, которое вы выпускаете, отправьте на адрес IPIA@microsoft.com сообщение электронной почты со следующими сведениями: If you already have a signed IPIA and want to add a new App ID for an application you are releasing, send an email to IPIA@microsoft.com and provide us with the following information:

• название приложения компании; Name of the Company Application
• краткое описание приложения; Brief Description of the Application
• идентификатор клиента Azure (даже если он не изменился); Azure Tenant ID (even if the same one as before)
• идентификатор приложения; App ID for the application
• контактные лица компании, электронная почта и телефон для связи в критической ситуации. Company contacts, email, and phone for Critical Situation Correspondence

Отправив сообщение электронной почты, подождите 72 часа до подтверждения получения. Upon the sending of the email, allow up to 72 hours for an acknowledgment of the receipt.

Обеспечение необходимой среды выполнения для приложения Ensure your app has the required runtime

Это действие необходимо только в том случае, если приложение развертывается на компьютере без Visual Studio или если в установке Visual Studio нет компонентов среды выполнения Visual C++. This step is necessary only if deploying the application to a machine without Visual Studio, or if the Visual Studio installation lacks the Visual C++ Runtime components.

Для приложений, созданных с использованием пакета SDK для MIP, требуется среда выполнения Visual C++ 2015 или Visual C++ 2017. Applications built with the MIP SDK require the Visual C++ 2015 or Visual C++ 2017 runtime to be installed, if not already present.

Эти среды работают только для сборки выпуска приложения. These will only work if the application has been built as Release. Для отладочной сборки библиотеки DLL отладки среды выполнения Visual C++ необходимо включить в приложение или установить на компьютере. If the application is built as Debug, then the Visual C++ runtime debug DLLs must be included with the application or installed on the machine.