Documentation –

Developer-Guide: Aspose.Cells Cloud Excel Password Protection Web API – Автоматизация шифрования паролей открытия и изменения

Mon, 01 Jan 0001 00:00:00 +0000

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

API защиты электронной таблицы

Web API

PUT https://api.aspose.cloud/v4.0/cells/protection/spreadsheet

Безопасность и аутентификация

Aspose.Cells Cloud API защищены и требуют аутентификации на основе JWT-токена.

-H "Authorization: Bearer {access_token}"

Параметры запроса:

Имя параметра	Тип	Путь/Строка запроса/Тело HTTP-запроса	Описание
Spreadsheet	File	FormData	Файл электронной таблицы Excel для загрузки и защиты шифрованием пароля.
openPassword	String	Query	Пароль, необходимый для открытия (расшифровки) защищенной электронной таблицы.
modifyPassword	String	Query	Пароль, необходимый для включения редактирования или изменения содержимого электронной таблицы.
outPath	String	Query	(Необязательно) Указывает путь к выходной папке, куда будет сохранена защищенная книга. Если не указано, файл возвращается в ответе.
outStorageName	String	Query	Имя облачного хранилища, используемого для хранения защищенного выходного файла.
region	String	Query	Указывает региональные/культурные настройки (например, формат даты, форматирование чисел), применяемые к электронной таблице во время обработки.

Аутентификация
Все вызовы API защиты электронной таблицы требуют действительного токена доступа OAuth 2.0. Включите токен в заголовке Authorization:

Authorization: Bearer {access_token}

Токен должен быть получен из точки аутентификации Aspose Cloud и должен включать область доступа Cells.

Ответ

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

Коды HTTP-статуса

Код	Значение	Описание
200	OK (ОК)	Фильтр успешно применен; ответ содержит подробности операции.
400	Bad Request (Неверный запрос)	Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла).
401	Unauthorized (Неавторизован)	Недействительный или отсутствующий JWT-токен.
413	Payload Too Large (Слишком большой полезный груз)	Загруженный файл превышает лимит размера.
500	Internal Server Error (Внутренняя ошибка сервера)	Непредвиденная ошибка сервера.

Где следует использовать API защиты электронной таблицы?

Защита конфиденциальных финансовых данных – Защищайте файлы Excel, содержащие бюджеты, счета или данные по заработной плате, с помощью паролей открытия и изменения, чтобы предотвратить несанкционированный доступ или изменения.
Безопасное распространение конфиденциальных отчетов – Убедитесь, что только авторизованные получатели могут просматривать или изменять бизнес-, аудиторские или отчеты по соответствию при внутреннем или внешнем распространении.
Автоматизация безопасности документов в рабочих процессах – Интегрируйте API в корпоративные системы (например, ERP, CRM) для автоматической защиты паролем создаваемых электронных таблиц перед их сохранением или отправкой по электронной почте.
Принудительное предоставление доступа только для чтения – Разрешите пользователям открывать отчеты для просмотра, ограничивая при этом изменения с помощью отдельного пароля изменения — идеально подходит для шаблонов или завершенных наборов данных.
Соответствие нормативным требованиям – Помогите соблюдать требования GDPR, HIPAA или SOX, шифруя конфиденциальные данные электронных таблиц при хранении и передаче с помощью автоматизированной защиты.

Почему следует использовать API защиты электронной таблицы?

Удобный для разработчиков – Aspose.Cells Cloud предоставляет SDK-библиотеки на множестве языков программирования, что обеспечивает быструю разработку, и сопровождается подробной документацией. По сравнению с созданием собственных решений это значительно снижает трудозатраты на разработку.
Снижение потребности в персонале – Автоматизирует консолидацию и безопасность документов, снижая потребность в выделенных сотрудниках.
Платежи по факту использования – Никаких предварительных инвестиций; вы платите только за те вызовы API, которые фактически используете.
Отсутствие затрат на обслуживание – Нет серверов для обслуживания, обновлений программного обеспечения и проблем совместимости.
Сохранение всех исходных форматов Excel при применении защиты паролем, что гарантирует, что защищенная книга выглядит точно так же, как исходный файл.

Как использовать API защиты электронной таблицы с помощью SDK

Спецификация OpenAPI

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

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

Запрос

curl -X PUT "https://api.aspose.cloud/v4.0/cells/protection/spreadsheet?openPassword=MyOpenPwd&modifyPassword=MyModifyPwd" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@/path/to/workbook.xlsx"

Ответ

{
  "type": "FileContentResult",
  "fileContents": "byte[] (Base64 закодированные)",
  "contentType": "MIME-тип",
  "fileDownloadName": "необязательное имя файла"
}

Использование SDK Aspose.Cells Cloud

Использование SDK — это лучший способ ускорить разработку. SDK обрабатывает все низкоуровневые детали, позволяя вам просто реализовать функциональность защиты электронной таблицы с минимальным количеством кода. Ознакомьтесь с полным списком SDK Aspose.Cells Cloud в репозитории GitHub.

Следующие примеры кода демонстрируют взаимодействие с веб-сервисами Aspose.Cells с использованием различных SDK:

Developer-Guide: Aspose.Cells Cloud Excel Unprotect Web API — программное удаление паролей на открытие и изменение

Mon, 01 Jan 0001 00:00:00 +0000

API Unprotect Spreadsheet удаляет защиту паролями на открытие и изменение из файлов Excel за один вызов. Это идеальное решение для конвейеров данных, систем управления документами и рабочих процессов миграции.

API Unprotect Spreadsheet

Веб-API

PUT https://api.aspose.cloud/v4.0/cells/unprotection/spreadsheet

Безопасность и аутентификация

Aspose.Cells Cloud API защищены и требуют аутентификации на основе JWT-токена.

-H "Authorization: Bearer {access_token}"

Параметры запроса

Имя параметра	Тип	Расположение	Описание
Spreadsheet	File	FormData	Файл Excel, для которого требуется снять защиту.
password	String	Query	Пароль, защищающий файл от открытия.
modifyPassword	String	Query	Пароль, необходимый для изменения файла (необязательный, если задан только пароль открытия).
outPath	String	Query	(Необязательный) Путь к папке, куда будет сохранена расшифрованная рабочая книга.
outStorageName	String	Query	(Необязательный) Имя хранилища, в которое будет записан выходной файл.
region	String	Query	(Необязательный) Настройки региона электронной таблицы.

Ответ

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream",
      "Name": "file"
    }
  }
]

Успешный ответ возвращает расшифрованный файл в виде потока. Файл может быть сохранен в местоположение, указанное в outPath/outStorageName, или получен непосредственно из полезной нагрузки ответа.

Коды HTTP-статуса

Код	Значение	Описание
200	OK (ОК)	Фильтр успешно применён; ответ содержит детали операции.
400	Bad Request (Неверный запрос)	Отсутствуют или некорректны параметры (например, неподдерживаемый тип файла).
401	Unauthorized (Неавторизован)	Неверный или отсутствующий JWT-токен.
413	Payload Too Large (Слишком большой запрос)	Загруженный файл превышает лимит размера.
500	Internal Server Error (Внутренняя ошибка сервера)	Непредвиденная ошибка сервера.

Когда следует использовать API Unprotect Spreadsheet?

Восстановление доступа к заблокированным рабочим книгам — быстро удаляйте забытые пароли на открытие или изменение без ручного вмешательства.
Автоматизация массовой разблокировки — обрабатывайте большое количество файлов в проектах миграции данных или архивирования.
Интеграция с существующими рабочими процессами — объединяйте с API хранилищ или преобразования для создания сквозных конвейеров (например, загрузка → снятие защиты → преобразование в PDF).
Обеспечение безопасности данных — операция выполняется на стороне сервера, что сохраняет оригинальные файлы в безопасности, а расшифрованная версия сохраняется в вашем облачном хранилище.

Как использовать API Unprotect Spreadsheet с SDK

Спецификация OpenAPI

Спецификация API UnProtect Spreadsheet предоставляет общедоступный программный интерфейс, позволяющий выполнять прямые REST-вызовы из веб-браузера.

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. В следующем примере показано, как сделать вызовы в Cloud API с помощью cURL.

Запрос

curl -X PUT "https://api.aspose.cloud/v4.0/cells/unprotection/spreadsheet?password=OldPass&modifyPassword=ModPass" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@myfile.xlsx"

Ответ

{
  "type": "FileContentResult",
  "fileContents": "byte[] (Base64 закодировано)",
  "contentType": "MIME-тип",
  "fileDownloadName": "необязательное имя файла"
}

Использование SDK Aspose.Cells Cloud

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

Следующие примеры кода иллюстрируют, как вызывать API Unprotect Spreadsheet с использованием различных SDK: