Skip to content

Information Retrieval Interface ("IRI")

The following is a general description of the Information Retrieval Interface ("IRI") provided by the Registry. The information provided by the IRI is real-time information.

Access

The IRI is accessed by HTTP – at the following URL: http://iri.isoc.org.il/. Access to the IRI is allowed only from IP addresses pre-registered with the Registry in advance.

Login Page

Upon accessing the above URL, the following screen will appear:

IRI Login Page

Where:

  • "Registrar Code": the AR Code.

  • "User Login" and "Password": Please refer to the following section on User Management.

Users Management

At the Registry, a single principal user is defined for each AR. This user has the authority to independently manage additional IRI users as needed.

The principal user's user name is managed at Registry level. An initial password is also allocated by the Registry. This password can be independently managed by the user.

Main Page

Following a successful login, IRI's main page will appear:

IRI Main Page

Where:

  • "Currently available credit ...": Indicates current amount available for submission of additional Registration Actions, expressed in Registration Units.
  • "Credit assigned to pending request": Indicates the amount deducted from the available credit and has been allocated to Registration Actions that are pending for processing, expressed in Registration Units. Where a Registration Action is denied, the credit assigned to it will 'return' to the available credit.
  • "Requests in Process": Indicates the number and type of Registration Actions that have been submitted and are pending processing.
  • "(a) Queries": The main tool to query Domain Name Records, Contact Objects and status of Registration Actions:
    • "WHOIS Query": perform a WHOIS query of a specific Domain Name Record or Contact Object. This is the general WHOIS utility. Any Domain Name Record can be queried, not only such that are managed by the AR. This option will lead to the screen described in WHOIS query.
    • "Domains managed by [AR Name]": Query Domain Name Records managed by the AR. This option will lead to the screen described in Query Domain Names managed by an AR.
    • "Contacts managed by [AR Name]": Query Contact Objects managed by the AR. This option will lead to the screen described in Query Contacts Managed by an AR.
    • "Query Domain Requests": Query the status of Registration Actions pertaining to Domain Name Records. This option will lead to the screen described in Query status of requests pertaining to Domain Name Records.
    • "Query Contact Requests": Query the status of Registration Actions pertaining to Contact Objects. This option will lead to the screen described in Query status of requests pertaining to Contact Object.
  • "Credit Log": See a complete history of AR's credit purchases. This option will lead to the screen described in Credit Log.
  • "Purchase Credit: Submit a request to purchase credit. This option will lead to the screen described in Purchase Credit.
  • "Manage Password": Manage the password of the current IRI user. This option will lead to the screen described in Manage Password.
  • "Manage Authorized Users for this system": This option is available only to the principal user registered at the Registry. It is used to manage IRI sub-users. This option will lead to the screen described in Manage IRI Authorized Users.
  • "Number of Domains": Indicates the number of Domain Name Records currently managed by the AR – with SLD breakdown, and total number.
  • "Log Off": Exit the IRI system and return to the Login Page.
  • Upper Navigation Menu: Allows for quick navigation between the different options. This menu appears in all screens.

WHOIS Query

IRI WHOIS

Perform a standard WHOIS query on a specific Domain Name or Contact Object. To query a Domain Name, type a full 3rd level .il name, e.g., sample.co.il. To query a Contact Object, type the Contact's Handle, e.g, BL-AB1-IL.

No wildcards allowed in this query.

"Back": Return to Main screen.

Query Domain Names managed by an AR

IRI query Domain Names

The results of the query will be only Domain Name Records that match the search criterion entered, and are managed by the AR. Only one criterion should be used per query:

  • "Domain Name": A string representing a Domain Name or part of it. The character * may be used as wildcard. For example, to search for the AR's Domain Names that start with an a, type: a*.
  • "Type": Search by Domain Name's character set type. Latin names, Hebrew names or Both (default)
  • "Registration Period Between"; "Expiry Period Between"; "Date of Management Between": Dates MUST be entered in dd/MM/YYYY format.
  • "Lock Transfer Status": Indicates whether Domain Name is locked for Transfer or not.
  • "DNSSEC Status": Indicates whether Domain Name is secured or not.
  • "Sort by": Controls the order in which results are presented.
  • "Export Table": Export the table to a Comma Separated Values file (.csv).
  • "Submit Query": If no query criterion is entered, all Domain Names managed by the AR will be displayed.
  • "Back": Return to Main screen.

Query Contacts Managed by an AR

IRI query Contacts

  • "Handle": Enter a complete or part of a Handle. The character * may be used as wildcard. For example, to search for the AR's Contact whose handle starts with an a, type: [AR Code]-a*.
  • "Name": Search a Contact by name. The character * may be used as wildcard. For example, to search for the AR's Contact whose name starts with an a, type: a*.
  • "With Related Domain Names": This option should be marked if the query is for Handles that are currently registered as a Contact in at least one Domain Name Record.
  • "Only Orphan Contacts": This option should be marked if the query is for Handles that currently do not appear as a Contact in any Domain Name Record.
  • "Export Table": Export the table to a Comma Separated Values file (.csv).
  • "Submit Query": If no query criterion is entered, all Domain Names managed by the AR will be displayed.
  • "Back": Return to Main screen.

Query status of requests pertaining to Domain Name Records

IRI query Domain Name requests

  • "Request ID": Locate a specific Registration Action by its Request ID number.
  • "Request Type": A combo which allows querying for a specific type of Registration Action (Create Domain, Update Domain, Reassign Domain, Delete Domain, Renew Domain, Transfer Domain).
  • "Domain Name": A string representing a Domain Name or part of it. The character * may be used as wildcard. For example, to search for the AR's Domain Names that start with an a, type: a*.
  • "Type": Search by Domain Name's character set type. Latin names, Hebrew names or Both (default)
  • "Submitted between", "End of process": Dates MUST be entered in dd/MM/YYYY format.
  • "Request Status": Possible statuses are:
    • "Received" – the Registration Action had been received at the API Server.
    • "In Process" – the Registration Action is currently in one of the processing stages (for example, a Transfer request waiting for the Managing AR's response.
    • "Approved" – the Registration Action was successfully processed, as requested.
    • "Denied" – the Registration Action has not been processed and was denied.
  • "Export Table": Export the table to a Comma Separated Values file (.csv).
  • "Submit Query": If no query criterion is entered, all Domain Names managed by the AR will be displayed.
  • "Back": Return to Main screen.
  • Search criteria can be combined to make complex queries, for example, query all Create Domain requests submitted between date X to date Y, and approved between date A and date B will involve 4 search criteria:
    • Request Type (Create Domain)
    • Submitted Between
    • End of Process
    • and Status (Approved).

Query status of requests pertaining to Contact Object

IRI query Contact requests

  • "Request ID": Locate a specific Registration Action by its svTRID number (excluding the isocil- and timestamp strings) – in isocil-12345 [timestamp] the request ID is the string 12345.
  • "Request Type": A combo which allows querying for a specific type of Registration Action (Create Contact, Update Contact).
  • "Contact Handle": Enter a complete or part of a Handle. The character * may be used as wildcard. For example, to search for the AR's Contact whose handle starts with an a, type: [AR Code]-a*.
  • "Submitted between", "End of process": Dates MUST be entered in dd/MM/YYYY format.
  • "Request Status": Possible statuses are:
    • "Received" – the Registration Action had been received at the API Server.
    • "In Process" – the Registration Action is currently in one of the processing stages (for example, a Transfer request waiting for the Managing AR's response.
    • "Approved" – the Registration Action was successfully processed, as requested.
    • "Denied" – the Registration Action has not been processed and was denied.
  • "Export Table": Export the table to a Comma Separated Values file (.csv).
  • "Submit Query": If no query criterion is entered, all Domain Names managed by the AR will be displayed.
  • "Back": Return to Main screen.
  • Search criteria can be combined to make complex queries, for example, query all Create Contact requests submitted between date X to date Y, and approved between date A and date B will involve 4 search criteria:
    • Request Type (Create Contact)
    • Submitted Between
    • End of Process
    • and Status (Approved).

Credit Log

IRI Credit Log

This screen displays the history of credit purchases of the AR.

  • "Back": Back to the previous page.
  • "Main Menu": Back to Main screen.

Purchase Credit

IRI submit credit request

This is screen is used to submit a request to purchase credit. The details entered in this screen will be used to send a Pro-forma Invoice to the AR, for payment vis-à-vis ISOC-IL's accounting department.

  • "Amount": The amount of Registration Units with regard to which the invoice will be issued, (a drop-down menu).
  • "Email": The Email address to which the Pro-forma invoice will be sent.
  • "Remarks": When necessary, add remarks to the attention of ISOC-IL's accounting, in free text.
  • "Process": Submit the request.
  • "Back": Return to Main screen.

Upon submitting the request, the following Pro-forma invoice will be sent to email address specified:

Credit request form

Manage Password

IRI manage password

In this screen the IRI user can manage his/her password.

Management of user name is done at Registry level, in case of the principal user, and at principal user level in case of a sub-user.

  • "Old Password": The password that was used to enter the current IRI session.
  • "New Password", "Retype New Password": Password MUST be at least 4 chars long.

Manage IRI Authorized Users

IRI manage users

This option is only accessible to the AR Principal User. It allows for the management of the IRI users.

An IRI user can be "Active", "Locked" (i.e., an active user temporarily blocked from accessing the IRI system). The "Not Active" indicates a user that is permanently blocked from accessing the IRI.

  • "Add new user": Use this option to add new IRI users to the system. It will lead to the following screen

IRI add user

  • "Name": The new IRI user regular name (given name and surname).
  • "Active": The user can access the IRI.
  • "Locked": An active user that is temporarily blocked from accessing the IRI.
  • "User Name (login)": The new IRI user's login name, MUST be at least 4 characters long.
  • "Password", "Retype Password": Password MUST be at least 4 characters long.
  • "Save": The information MUST be saved prior to exiting the screen, otherwise the new user will not be created.