abp-next-admin/aspnet-core/framework/cloud-aliyun/LINGYUN.Abp.Aliyun/README.EN.md

LINGYUN.Abp.Aliyun

Alibaba Cloud SDK integration module.

Reference: Alibaba Cloud API Documentation

Features

• Provides basic SDK integration for Alibaba Cloud services
• Supports Alibaba Cloud RAM (Resource Access Management) authentication
• Supports STS Token access
• Supports Alibaba Cloud SMS service
• Supports Alibaba Cloud Object Storage Service (OSS)
• Provides distributed cache support for optimizing high concurrency scenarios

Module Reference

[DependsOn(typeof(AbpAliyunModule))]
public class YouProjectModule : AbpModule
{
  // other
}

Configuration Items

Authentication Configuration

• AliyunSettingNames.Authorization.RegionId

  • Description: Alibaba Cloud service region
  • Type: Optional
  • Default value: default
  • Example: oss-cn-hangzhou

• AliyunSettingNames.Authorization.AccessKeyId

  • Description: AccessKey ID of Alibaba Cloud RAM account
  • Type: Required
  • How to get: Access Alibaba Cloud Console - Access Control

• AliyunSettingNames.Authorization.AccessKeySecret

  • Description: AccessKey Secret of RAM account
  • Type: Required
  • How to get: Access Alibaba Cloud Console - Access Control

STS Token Configuration

• AliyunSettingNames.Authorization.UseSecurityTokenService

  • Description: Whether to use STS Token access
  • Type: Optional
  • Default value: false
  • Recommendation: Recommended to enable for improved security

• AliyunSettingNames.Authorization.RamRoleArn

  • Description: Alibaba Cloud RAM role ARN
  • Type: Required when STS Token is enabled
  • Format: acs🐏:$accountID:role/$roleName

• AliyunSettingNames.Authorization.RoleSessionName

  • Description: Custom token name
  • Type: Optional
  • Usage: For access auditing

• AliyunSettingNames.Authorization.DurationSeconds

  • Description: Token expiration time
  • Type: Optional
  • Default value: 3000
  • Unit: Seconds

• AliyunSettingNames.Authorization.Policy

  • Description: Permission policy
  • Type: Optional
  • Format: JSON string

Performance Optimization

• In high concurrency scenarios, it is recommended to enable distributed caching to improve performance
• When using STS Token, the token will be automatically cached until expiration
• It is recommended to set DurationSeconds reasonably to avoid frequent token refreshes

Related Modules

• LINGYUN.Abp.Aliyun.SettingManagement - Provides configuration management functionality
• LINGYUN.Abp.Aliyun.Features - Provides feature management functionality

查看中文文档