NetWorker REST API: RESTAPI isteklerini işlerken uzak bir AUTHC sunucusu nasıl kullanılır?

NetWorker veri koruması hizmetine erişmek için NetWorker Temsili Durum Aktarımı (REST) Uygulama Programlama Arayüzü (API) kullanılır. Tüm NetWorker sunucuları, NetWorker Kimlik Doğrulaması (AUTHC) işlevini içerir. Çok sunuculu ortamlarda yalnızca bir AUTHC sunucusu NetWorker kimlik doğrulamasını işleyebilir. Bu, ortama ve yapılandırmaya özgü olabilir. Bu gibi senaryolarda API istekleri sırasında "AUTHC" sunucusunun belirtilmesi gerekebilir. Bu yapılandırma, bu makalede "uzak AUTHC sunucusu" olarak adlandırılmaktadır. Uzak AUTHC sunucusu API çağrısında belirtilmezse geçersiz kimlik bilgileri, yetkisiz erişim veya eksik izinler olduğunu gösteren HTTP hatalarıyla başarısız olabilir. NetWorker REST API v3 ve daha yeni sürümleri, özel bir başlığa sahip AUTHC sunucusunu içerebilir. Bu makalede, NetWorker Management Console (NMC) tarafından kullanılan AUTHC sunucusunun hangi ana bilgisayar olduğunun nasıl belirleneceği ve X-NW-AUTHC-BASE-URL API başlığı.

REST API için "uzak AUTHC sunucusu" kullanma:

Anahtar değeri, AUTHC sunucusu IP adresini veya tam nitelikli etki alanı adını (FQDN) ve AUTHC bağlantı noktasını (varsayılan=9090) sağlamalıdır:

Key: X-NW-AUTHC-BASE-URL
Value: REMOTE_AUTHC_SERVER_ADDRESS:9090

NetWorker kimlik doğrulamasını daha iyi anlamak için REST API kimlik doğrulamasını NetWorker Management Console (NMC) ve NetWorker Web Kullanıcı Arayüzü (NWUI) kimlik doğrulamasıyla karşılaştıralım. Her NetWorker sunucusunun kendi AUTHC sunucusu vardır; ancak bu, yerel NetWorker kullanıcılarının veya harici (AD/LDAP) kullanıcıların yapılandırıldığı ana bilgisayar olmayabilir. Bu, NetWorker ortamının nasıl yapılandırıldığına bağlı olarak değişir.

• NMC: NMC kimlik doğrulaması, kurulum sırasında (Windows) ve kurulum sonrasında (Linux) yapılandırılır. Dağıtım sırasında bir AUTHC sunucusu belirtilir ve tüm kimlik doğrulama istekleri AUTHC ana bilgisayarına yönlendirilir. Bir AUTHC ana bilgisayarının birden fazla NetWorker sunucusuna yönelik istekleri yönetmesi mümkündür. AUTHC ana bilgisayarı şu şekilde tanımlanır: authsvc_hostname NMC sunucusunda gstd.conf :
  • Linux: /opt/lgtonmc/etc/gstd.conf
  • Windows (Varsayılan): C:\Program Files\EMC NetWorker\Management\GST\etc\gstd.conf
• NWUI: NWUI kimlik doğrulaması, kurulum sırasında (Windows) ve kurulum sonrasında (Linux) yapılandırılır. Dağıtım sırasında bir AUTHC sunucusu belirtilir ve tüm kimlik doğrulama istekleri AUTHC ana bilgisayarına yönlendirilir. Bir AUTHC ana bilgisayarının birden fazla NetWorker sunucusuna yönelik istekleri yönetmesi mümkündür. Uzak kimlik doğrulama sunucusu genellikle NetWorker sunucusundaki bir nsradmin isteminden tanımlanabilir:

nsradmin
show name; external roles
print type: nsr usergroup; name: Application Administrators

# nsradmin
NetWorker administration program.
Use the "help" command for help, "visual" for full-screen mode.
nsradmin> show name; external roles
nsradmin> print type: nsr usergroup; name: application administrators
                        name: Application Administrators;
              external roles: \
"cn=Administrators,cn=Groups,dc=nve,dc=networker,dc=lan",
"cn=Administrators,cn=Groups,dc=WIN-SRVR02,dc=networker,dc=lan",
"CN=NetWorker_Admins,OU=DELL,dc=networker,dc=lan";
nsradmin>

Key: X-NW-AUTHC-BASE-URL
Value: REMOTE_AUTHC_SERVER_ADDRESS:9090

Söz Dizimi:

curl -k --header "X-NW-AUTHC-BASE-URL:REMOTE_AUTHC_SERVER_ADDRESS:9090" --user USER_ACCOUNT "https://NETWORKER_SERVER_ADDRESS:9090/nwrestapi/v3/global/"

nve:~ # curl -v -k --header "X-NW-AUTHC-BASE-URL:win-srvr02.networker.lan:9090" --user "networker.lan\bkupadmin" "https://nve.networker.lan:9090/nwrestapi/v3/global/jobs"
Enter host password for user 'networker.lan\bkupadmin':
*   Trying 192.168.0.4:9090...
* Connected to nve.networker.lan (192.168.0.4) port 9090 (#0)
..
* Server auth using Basic with user 'networker.lan\bkupadmin'
> GET /nwrestapi/v3/global/jobs HTTP/1.1
> Host: nve.networker.lan:9090
...
> X-NW-AUTHC-BASE-URL:win-srvr02.networker.lan:9090
>
< HTTP/1.1 200
...
<
{"count":471,"jobs":[{JOBDSB JSON CONTENT}]

Günlükler:

Kimlik Doğrulama Sunucusu:

Linux: /nsr/authc/logs
Windows: C:\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs

REST API (NetWorker Sunucusu):

Linux: /nsr/logs/restapi/restapi.log
Windows: C:\Program Files\EMC NetWorker\nsr\logs\restapi\restapi.log